io.jenkins.plugins.folderauth

Class FolderAuthorizationStrategyManagementLink

java.lang.Object

hudson.model.ManagementLink

io.jenkins.plugins.folderauth.FolderAuthorizationStrategyManagementLink

All Implemented Interfaces:

ExtensionPoint, Action, ModelObject

@Extension
 @ParametersAreNonnullByDefault
public class FolderAuthorizationStrategyManagementLink
extends ManagementLink

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class hudson.model.ManagementLink

LIST

Constructor Summary

Constructors

Constructor and Description
FolderAuthorizationStrategyManagementLink()

Method Summary

Modifier and Type	Method and Description
void	doAddAgentRole(AgentRoleCreationRequest request) Adds an AgentRole to FolderBasedAuthorizationStrategy.
void	doAddFolderRole(FolderRoleCreationRequest request) Adds a FolderRole to FolderBasedAuthorizationStrategy.
void	doAddGlobalRole(GlobalRoleCreationRequest request) Adds a GlobalRole to FolderBasedAuthorizationStrategy.
void	doAssignSidToAgentRole(String roleName, String sid) Assigns sid to the AgentRole identified by roleName.
void	doAssignSidToFolderRole(String roleName, String sid) Assigns sid to the folder role identified by roleName.
void	doAssignSidToGlobalRole(String roleName, String sid) Assigns sid to the global role identified by roleName.
void	doDeleteAgentRole(String roleName) Deletes an AgentRole from the FolderBasedAuthorizationStrategy.
void	doDeleteFolderRole(String roleName) Deletes a folder role.
void	doDeleteGlobalRole(String roleName) Deletes a global role.
net.sf.json.JSONArray	doGetAllFolders() Get all AbstractFolders in the system
Set<Permission>	getAgentPermissions()
Set<AgentRole>	getAgentRoles()
List<Computer>	getAllComputers() Get all Computers in the system
String	getDisplayName()
Set<Permission>	getFolderPermissions()
Set<FolderRole>	getFolderRoles() Returns the FolderRoles used by the FolderBasedAuthorizationStrategy.
Set<Permission>	getGlobalPermissions()
Set<GlobalRole>	getGlobalRoles()
String	getIconFileName()
String	getUrlName()

Methods inherited from class hudson.model.ManagementLink

all, getDescription, getRequiredPermission, getRequiresConfirmation, getRequiresPOST

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FolderAuthorizationStrategyManagementLink

public FolderAuthorizationStrategyManagementLink()

Method Detail

getIconFileName

@CheckForNull
public String getIconFileName()

Specified by:

getIconFileName in interface Action

Specified by:

getIconFileName in class ManagementLink

getUrlName

@CheckForNull
public String getUrlName()

Specified by:

getUrlName in interface Action

Specified by:

getUrlName in class ManagementLink

getDisplayName

@CheckForNull
public String getDisplayName()

getGlobalPermissions

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public Set<Permission> getGlobalPermissions()

getFolderPermissions

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public Set<Permission> getFolderPermissions()

getAgentPermissions

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public Set<Permission> getAgentPermissions()

doAddGlobalRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doAddGlobalRole(@JsonBody
                                                                                                    GlobalRoleCreationRequest request)
                                                                                             throws IOException

Adds a GlobalRole to FolderBasedAuthorizationStrategy.

Parameters:

request - the request to create the GlobalRole

Throws:

IOException - when unable to add Global role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

doAssignSidToGlobalRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doAssignSidToGlobalRole(@QueryParameter(required=true)
                                                                                                            String roleName,
                                                                                                            @QueryParameter(required=true)
                                                                                                            String sid)
                                                                                                     throws IOException

Assigns sid to the global role identified by roleName.

Does not do anything if a role corresponding to the roleName does not exist.

Parameters:

roleName - the name of the global to which sid will be assigned to.

sid - the sid of the user/group to be assigned.

Throws:

IOException - when unable to assign the Sid to the role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

NoSuchElementException - when no role with name equal to roleName exists.

doAddFolderRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doAddFolderRole(@JsonBody
                                                                                                    FolderRoleCreationRequest request)
                                                                                             throws IOException

Adds a FolderRole to FolderBasedAuthorizationStrategy.

Parameters:

request - the request to create the role

Throws:

IOException - when unable to add the role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

doAddAgentRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doAddAgentRole(@JsonBody
                                                                                                   AgentRoleCreationRequest request)
                                                                                            throws IOException

Adds an AgentRole to FolderBasedAuthorizationStrategy.

Parameters:

request - the request to create the role

Throws:

IOException - when unable to add the role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

doAssignSidToFolderRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doAssignSidToFolderRole(@QueryParameter(required=true)
                                                                                                            String roleName,
                                                                                                            @QueryParameter(required=true)
                                                                                                            String sid)
                                                                                                     throws IOException

Assigns sid to the folder role identified by roleName.

Parameters:

roleName - the name of the global to which sid will be assigned to.

sid - the sid of the user/group to be assigned.

Throws:

IOException - when unable to assign the Sid to the role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

NoSuchElementException - when no role with name equal to roleName exists.

doAssignSidToAgentRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doAssignSidToAgentRole(@QueryParameter(required=true)
                                                                                                           String roleName,
                                                                                                           @QueryParameter(required=true)
                                                                                                           String sid)
                                                                                                    throws IOException

Assigns sid to the AgentRole identified by roleName.

Parameters:

roleName - the name of the global to which sid will be assigned to.

sid - the sid of the user/group to be assigned.

Throws:

IOException - when unable to assign the Sid to the role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

NoSuchElementException - when no role with name equal to roleName exists.

getGlobalRoles

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public Set<GlobalRole> getGlobalRoles()

doGetAllFolders

@GET
 @Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public net.sf.json.JSONArray doGetAllFolders()

Get all AbstractFolders in the system

Returns:

full names of all AbstractFolders in the system

getAllComputers

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public List<Computer> getAllComputers()

Get all Computers in the system

Returns:

all Computers in the system

getFolderRoles

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public Set<FolderRole> getFolderRoles()

Returns the FolderRoles used by the FolderBasedAuthorizationStrategy.

Returns:

the FolderRoles used by the FolderBasedAuthorizationStrategy

Throws:

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

getAgentRoles

@Nonnull
 @Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public Set<AgentRole> getAgentRoles()

doDeleteGlobalRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doDeleteGlobalRole(@QueryParameter(required=true)
                                                                                                       String roleName)
                                                                                                throws IOException

Deletes a global role.

Parameters:

roleName - the name of the role to be deleted

Throws:

IOException - when unable to delete the role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

IllegalArgumentException - when trying to delete the admin role

NoSuchElementException - when no role with name equal to roleName exists.

doDeleteFolderRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doDeleteFolderRole(@QueryParameter(required=true)
                                                                                                       String roleName)
                                                                                                throws IOException

Deletes a folder role.

Parameters:

roleName - the name of the role to be deleted

Throws:

IOException - when unable to delete the role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

NoSuchElementException - when no role with name equal to roleName exists.

doDeleteAgentRole

@Restricted(value=org.kohsuke.accmod.restrictions.NoExternalUse.class)
public void doDeleteAgentRole(@QueryParameter(required=true)
                                                                                                      String roleName)
                                                                                               throws IOException

Deletes an AgentRole from the FolderBasedAuthorizationStrategy.

Parameters:

roleName - the name of the role to be deleted

Throws:

IOException - when unable to delete the role

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

NoSuchElementException - when no role with name equal to roleName exists.