@@ -0,0 +1,2397 @@
+/*%0A * Licensed to the Apache Software Foundation (ASF) under one%0A * or more contributor license agreements.  See the NOTICE file%0A * distributed with this work for additional information%0A * regarding copyright ownership.  The ASF licenses this file%0A * to you under the Apache License, Version 2.0 (the%0A * %22License%22); you may not use this file except in compliance%0A * with the License.  You may obtain a copy of the License at%0A *%0A *   http://www.apache.org/licenses/LICENSE-2.0%0A *%0A * Unless required by applicable law or agreed to in writing,%0A * software distributed under the License is distributed on an%0A * %22AS IS%22 BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY%0A * KIND, either express or implied.  See the License for the%0A * specific language governing permissions and limitations%0A * under the License.%0A */%0A%0Apackage org.apache.guacamole.net.auth;%0A%0Aimport org.apache.guacamole.GuacamoleException;%0Aimport org.apache.guacamole.net.auth.credentials.UserCredentials;%0A%0A/**%0A * An object which can be shared with others via specially-generated sets of%0A * credentials. It is expected, but not required, that these credentials are%0A * temporary.%0A *%0A * @param %3CT%3E%0A *     The type of object which dictates the semantics/restrictions of shared%0A *     objects.%0A *%0A * @author Michael Jumper%0A */%0Apublic interface Shareable%3CT%3E %7B%0A%0A    /**%0A     * Returns a full set of credentials which can be used to authenticate as a%0A     * user with access strictly to this object. The semantics and restrictions%0A     * of the shared object (when accessed using the returned sharing%0A     * credentials) are defined by the %7B@link T%7D associated with the given%0A     * identifier and within the%0A     * %7B@link Directory%7D&lt;%7B@link T%7D&gt; of the same %7B@link UserContext%7D that%0A     * this Shareable was retrieved from.%0A     *%0A     * @param identifier%0A     *     The identifier of a %7B@link T%7D within the%0A     *     %7B@link Directory%7D&lt;%7B@link T%7D&gt; of the same %7B@link UserContext%7D%0A     *     that this Shareable was retrieved from.%0A     *%0A     * @return%0A     *     A full set of credentials which can be used to authenticate and%0A     *     obtain access to this object.%0A     *%0A     * @throws GuacamoleException%0A     *     If credentials could not be generated, or permission to share this%0A     *     object is denied.%0A     */%0A    public UserCredentials getSharingCredentials(String identifier)%0A            throws GuacamoleException;%0A%0A%7D%0A

Define Shareable interface which defines a mechanism for generating (likely temporary) credentials.