com.freedomotic.security.Auth Maven / Gradle / Ivy

Go to download
/**
 *
 * Copyright (c) 2009-2014 Freedomotic team http://freedomotic.com
 *
 * This file is part of Freedomotic
 *
 * This Program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License as published by the Free Software
 * Foundation; either version 2, or (at your option) any later version.
 *
 * This Program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License along with
 * Freedomotic; see the file COPYING. If not, see
 * .
 */
package com.freedomotic.security;

import com.freedomotic.api.Plugin;
import java.util.Map;
import org.apache.shiro.authz.SimpleRole;
import org.apache.shiro.authz.annotation.RequiresPermissions;
import org.apache.shiro.realm.Realm;
import org.apache.shiro.subject.Subject;

/**
 *
 * @author Matteo Mazzoni 
 */
public interface Auth {

    /**
     *
     */
    public void initBaseRealm();

    /**
     *
     * @return
     */
    public boolean isInited();

    /**
     *
     * @param key
     * @return
     */
    public boolean isPermitted(String key);

    /**
     *
     * @param subject
     * @param password
     * @return
     */
    public boolean login(String subject, char[] password);

    /**
     *
     * @param subject
     * @param password
     * @return
     */
    public boolean login(String subject, String password);

    /**
     *
     */
    public void logout();

    /**
     *
     * @return
     */
    public Subject getSubject();

    /**
     *
     * @return
     */
    public Object getPrincipal();

    /**
     *
     * @param plugin
     * @param action
     */
    public void pluginExecutePrivileged(Plugin plugin, Runnable action);

    /**
     *
     * @param plugin
     * @param permissions
     */
    public void setPluginPrivileges(Plugin plugin, String permissions);

    /**
     *
     * @return
     */
    public String getPluginDefaultPermission();

    /**
     *
     * @param rm
     */
    @RequiresPermissions("auth:realms:create")
    public void addRealm(Realm rm);

    /**
     *
     * @param userName
     * @return
     */
    @RequiresPermissions("auth:fakeUser")
    public boolean bindFakeUser(String userName);

    public void load();

    public void save();

    @RequiresPermissions("auth:users:create")
    public boolean addUser(String userName, String password, String role);

    @RequiresPermissions("auth:roles:create")
    public boolean addRole(SimpleRole role);

    public User getCurrentUser();
    
    @RequiresPermissions("auth:users:read")
    public User getUser(String username);
    
    @RequiresPermissions("auth:users:read")
    public Map getUsers();

    @RequiresPermissions("auth:roles:read")
    public SimpleRole getRole(String name);

    @RequiresPermissions("auth:roles:read")
    public Map getRoles();
    
    @RequiresPermissions("auth:users:delete")
    public boolean deleteUser(String userName);
    
    @RequiresPermissions("auth:roles:delete")
    public boolean deleteRole(String roleName);
    
    public Realm getUserRealm();
}