io.jenkins.plugins.folderauth

Class FolderAuthorizationStrategyManagementLink

java.lang.Object

hudson.model.ManagementLink

io.jenkins.plugins.folderauth.FolderAuthorizationStrategyManagementLink

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Action, hudson.model.ModelObject

@Extension
 @ExportedBean
 @ParametersAreNonnullByDefault
public class FolderAuthorizationStrategyManagementLink
extends hudson.model.ManagementLink

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.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<hudson.security.Permission>	getAgentPermissions()
Set<AgentRole>	getAgentRoles()
List<hudson.model.Computer>	getAllComputers() Get all Computers in the system
hudson.model.Api	getApi() Returns the Api for the plugin.
String	getDescription()
String	getDisplayName()
Set<hudson.security.Permission>	getFolderPermissions()
Set<FolderRole>	getFolderRoles() Returns the FolderRoles used by the FolderBasedAuthorizationStrategy.
Set<hudson.security.Permission>	getGlobalPermissions()
Set<GlobalRole>	getGlobalRoles()
String	getIconFileName()
String	getUrlName()

Methods inherited from class hudson.model.ManagementLink

all, 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 hudson.model.Action

Specified by:

getIconFileName in class hudson.model.ManagementLink

getDescription

@Nonnull
public String getDescription()

Overrides:

getDescription in class hudson.model.ManagementLink

getUrlName

@CheckForNull
public String getUrlName()

Specified by:

getUrlName in interface hudson.model.Action

Specified by:

getUrlName in class hudson.model.ManagementLink

getDisplayName

@CheckForNull
public String getDisplayName()

getGlobalPermissions

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

getFolderPermissions

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

getAgentPermissions

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

getApi

public hudson.model.Api getApi()

Returns the Api for the plugin.

Returns:

Api for the plugin.

See Also:

Wiki Article on exposing data to remote API.

doAddGlobalRole

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

Adds a GlobalRole to FolderBasedAuthorizationStrategy.

Parameters:

request - the request to create the GlobalRole

Throws:

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)

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:

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

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

doAddFolderRole

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

Adds a FolderRole to FolderBasedAuthorizationStrategy.

Parameters:

request - the request to create the role

Throws:

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

doAddAgentRole

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

Adds an AgentRole to FolderBasedAuthorizationStrategy.

Parameters:

request - the request to create the role

Throws:

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)

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:

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)

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:

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

IllegalArgumentException - 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<hudson.model.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)

Deletes a global role.

Parameters:

roleName - the name of the role to be deleted

Throws:

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

IllegalArgumentException - when trying to delete the admin role

IllegalArgumentException - 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)

Deletes a folder role.

Parameters:

roleName - the name of the role to be deleted

Throws:

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

IllegalArgumentException - 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)

Deletes an AgentRole from the FolderBasedAuthorizationStrategy.

Parameters:

roleName - the name of the role to be deleted

Throws:

IllegalStateException - when Jenkins.getAuthorizationStrategy() is not FolderBasedAuthorizationStrategy

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