Skip to content

Latest commit

 

History

History
174 lines (100 loc) · 9.46 KB

File metadata and controls

174 lines (100 loc) · 9.46 KB

SecurityIdentityApi

Method HTTP request Description
getByPath GET /securityidentities Retrieve a security identity by path.
get GET /securityidentities/{webId} Retrieve a security identity.
update PATCH /securityidentities/{webId} Update a security identity by replacing items in its definition.
delete DELETE /securityidentities/{webId} Delete a security identity.
getSecurity GET /securityidentities/{webId}/security Get the security information of the specified security item associated with the security identity for a specified user.
getSecurityEntries GET /securityidentities/{webId}/securityentries Retrieve the security entries associated with the security identity based on the specified criteria. By default, all security entries for this security identity are returned.
getSecurityEntryByName GET /securityidentities/{webId}/securityentries/{name} Retrieve the security entry associated with the security identity with the specified name.
getSecurityMappings GET /securityidentities/{webId}/securitymappings Get security mappings for the specified security identity.

getByPath

getByPath(String path, String selectedFields, String webIdType)

Retrieve a security identity by path.

Parameters

Name Type Description Notes
path String The path to the security identity.. [required]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

get

get(String webId, String selectedFields, String webIdType)

Retrieve a security identity.

Parameters

Name Type Description Notes
webId String The ID of the security identity.. [required]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

update

update(String webId, PISecurityIdentity securityIdentity)

Update a security identity by replacing items in its definition.

Parameters

Name Type Description Notes
webId String The ID of the security identity.. [required]
securityIdentity PISecurityIdentity A partial security identity containing the desired changes.. [required]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

delete

delete(String webId)

Delete a security identity.

Parameters

Name Type Description Notes
webId String The ID of the security identity.. [required]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getSecurity

getSecurity(String webId, List userIdentity, Boolean forceRefresh, String selectedFields, String webIdType)

Get the security information of the specified security item associated with the security identity for a specified user.

Parameters

Name Type Description Notes
webId String The ID of the security identity for the security to be checked.. [required]
userIdentity List The user identity for the security information to be checked. Multiple security identities may be specified with multiple instances of the parameter. If the parameter is not specified, only the current user's security rights will be returned.. [required]
forceRefresh Boolean Indicates if the security cache should be refreshed before getting security information. The default is 'false'.. [optional]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getSecurityEntries

getSecurityEntries(String webId, String nameFilter, String selectedFields, String webIdType)

Retrieve the security entries associated with the security identity based on the specified criteria. By default, all security entries for this security identity are returned.

Parameters

Name Type Description Notes
webId String The ID of the security identity.. [required]
nameFilter String The name query string used for filtering security entries. The default is no filter.. [optional]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getSecurityEntryByName

getSecurityEntryByName(String name, String webId, String selectedFields, String webIdType)

Retrieve the security entry associated with the security identity with the specified name.

Parameters

Name Type Description Notes
name String The name of the security entry. For every backslash character () in the security entry name, replace with asterisk (). As an example, use domainusername instead of domain\username.. [required]
webId String The ID of the security identity.. [required]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]

getSecurityMappings

getSecurityMappings(String webId, String selectedFields, String webIdType)

Get security mappings for the specified security identity.

Parameters

Name Type Description Notes
webId String The ID of the security identity.. [required]
selectedFields String List of fields to be returned in the response, separated by semicolons (;). If this parameter is not specified, all available fields will be returned.. [optional]
webIdType String Optional parameter. Used to specify the type of WebID. Useful for URL brevity and other special cases. Default is the value of the configuration item "WebIDType".. [optional]

Return type

[Back to top] [Back to API list] [Back to Model list] [Back to DOCUMENTATION]