aboutsummaryrefslogtreecommitdiffstats
path: root/upstream/odl-aaa-moon/aaa/aaa-authn-api/src/main/java/org/opendaylight/aaa/api/AuthenticationService.java
blob: 24ae9238692f7e66cec4500ef3aec815163d1e4c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/*
 * Copyright (c) 2014 Hewlett-Packard Development Company, L.P. and others.  All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
 * and is available at http://www.eclipse.org/legal/epl-v10.html
 */

package org.opendaylight.aaa.api;

/**
 * Authentication service to provide authentication context.
 */
public interface AuthenticationService {
    /**
     * Retrieve the current security context, or null if none exists.
     *
     * @return security context
     */
    Authentication get();

    /**
     * Set the current security context. Only {@link TokenAuth} should set
     * security context based on the authentication result.
     *
     * @param auth
     *            security context
     */
    void set(Authentication auth);

    /**
     * Clear the current security context.
     */
    void clear();

    /**
     * Checks to see if authentication is enabled.
     *
     * @return true if it is, false otherwise
     */
    boolean isAuthEnabled();
}