Overview
Version information
Version : 1.0.0
URI scheme
Host : cloudentity.dev.cloudentity.com
BasePath : /api
Schemes : HTTPS
Consumes
-
application/json
Produces
-
application/json
Paths
GET /admin/application/capability/resourceServers
Description
Lists applications with resource server capability. Only Resource Servers of user organization will be returned plus default Resource Server.
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
List of applications with resource server capability |
< ResourceServer > array |
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /admin/application/capability/resourceServers/scopes
Description
-
Lists permissions of all resource servers for a given customer.
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Customer Resource server scopes |
|
400 |
Error when something odd yet understandable happened |
No Content |
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
PUT /admin/application/{applicationId}/user/{userUuid}/permissions/grant
Description
Add user permissions.
Permissions that user alredy has will be silently ignored.
Returns current set of user permissions for application after the change.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
applicationId |
string |
|
Path |
userUuid |
string |
|
Body |
body |
User Permissions |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Current Set Of User Permissions For Application |
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
PUT /admin/application/{applicationId}/user/{userUuid}/permissions/revoke
Description
Removes user permissions
Permissions that user does not have will be silently ignored.
Returns current set of user permissions for application after the change.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
applicationId |
string |
|
Path |
userUuid |
string |
|
Body |
body |
User Permissions |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Current Set Of User Permissions For Application |
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /admin/application/{uuid}
Description
Get application as customer admin
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Application fetched |
|
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
DELETE /admin/application/{uuid}
Description
Delete application as customer admin
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
204 |
Application deleted |
No Content |
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /admin/application/{uuid}/capability/authorization
Description
Adds Authorization capability to application.
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
204 |
Application capability added |
No Content |
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /admin/application/{uuid}/capability/microservice
Description
Adds Microservice capability
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
uuid |
string |
|
Body |
body |
Identifier of microservice |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
204 |
Microservice capability added |
No Content |
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /admin/application/{uuid}/capability/oauthClient
Description
Admin get details of application OAuth capability
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Application details. |
|
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
PUT /admin/application/{uuid}/capability/oauthClient
Description
Admin modify OAuth Client Details.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
uuid |
string |
|
Body |
body |
Admin Update Application OAuth capability |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Application capability updated. |
|
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /admin/application/{uuid}/capability/resourceServer
Description
Adds Resource Server (RS) capability to application. Only one RS capability is allowed per application to be added. If such capability already exists a ValidationError will be returned
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
uuid |
string |
|
Body |
body |
Register Resource Server object |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Resource Server capability added |
|
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /admin/application/{uuid}/capability/resourceServer/oauthClientDetails
Description
Get details of Resource Server OAuthClients Details
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
OAuth capability details fetched |
|
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
DELETE /admin/application/{uuid}/capability/resourceServer/scope/{scopeName}
Description
Remove resource server scope
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
scopeName |
string |
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
204 |
Resource Server scope removed |
No Content |
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
DELETE /admin/application/{uuid}/capability/resourceServer/scope/{scopeName}/policy
Description
Unset policy for given resource server scope
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
scopeName |
string |
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
204 |
Resource Server Scope policy updated |
No Content |
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
PUT /admin/application/{uuid}/capability/resourceServer/scope/{scopeName}/policy/{policyName}
Description
Set policy for given resource server scope
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
policyName |
string |
Path |
scopeName |
string |
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
204 |
Resource Server Scope policy updated |
No Content |
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /admin/application/{uuid}/capability/resourceServer/scopes
Description
Add resource server scope
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
uuid |
string |
|
Body |
body |
Add Resource Server Scope object |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
201 |
Resource Server Scope created |
|
403 |
|
|
404 |
|
|
409 |
Resource Server Scope already exists |
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /admin/application/{uuid}/capability/resourceServer/scopes
Description
List resource server scopes
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Resource server scopes |
|
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /admin/applications
Description
Creates new application
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Body |
body |
Create Application object |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
201 |
Application created |
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /admin/applications
Description
List all applications for customer id from JWT token.
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
List of applications |
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /application/capability/resourceServers
Description
Lists applications with resource server capability. Only Resource Servers of user organization will be returned plus default Resource Server.
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
List of applications with resource server capability |
< ResourceServer > array |
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /application/{uuid}
Description
Get application
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Application fetched |
|
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
DELETE /application/{uuid}
Description
Delete application
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
204 |
Application deleted |
No Content |
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /application/{uuid}/capability/oauthClient
Description
Adds new OAuth application capability
Only one capability type per application is allowed
If such capability already exists a ValidationError will be returned
ApplicationType parameter value has influence on OAuthClient authorization method by mapping on OAuth Grant Types.
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
uuid |
string |
|
Body |
applicationType |
Type of OAuth Client application |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
OAuth capability added |
|
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /application/{uuid}/capability/oauthClient
Description
Get details of application OAuth capability
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
OAuth capability details fetched |
|
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
PUT /application/{uuid}/capability/oauthClient
Description
Modify OAuth application capability data set
All update object parameters are optional
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
uuid |
string |
|
Body |
body |
Update Application OAuth capability |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Application capability updated. Patch update of any attribute is possible. |
|
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /application/{uuid}/capability/oauthClient/secret
Description
Rotates OAuth client secret for provided application uuid
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
OAuth client secret rotated |
|
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /application/{uuid}/capability/resourceServer
Description
Get details of Resource Server capability
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
OAuth capability details fetched |
|
403 |
|
|
404 |
|
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /application/{uuid}/capability/resourceServer/scopes
Description
Add resource server scope
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Path |
uuid |
string |
|
Body |
body |
Add Resource Server Scope object |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
201 |
Resource Server Scope created |
|
403 |
|
|
404 |
|
|
409 |
Resource Server Scope already exists |
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /application/{uuid}/capability/resourceServer/scopes
Description
List resource server scopes
Parameters
| Type | Name | Schema |
|---|---|---|
Path |
uuid |
string |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
Resource server scopes |
|
403 |
|
|
404 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
POST /applications
Description
Creates new application
Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
Body |
body |
Create Application object |
Responses
| HTTP Code | Description | Schema |
|---|---|---|
201 |
Application created |
|
422 |
|
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
GET /applications
Description
List all applications for owner id from JWT token.
Responses
| HTTP Code | Description | Schema |
|---|---|---|
200 |
List of applications |
Tags
-
application
Security
| Type | Name |
|---|---|
oauth2 |
|
oauth2 |
|
oauth2 |
|
apiKey |
Definitions
AddResourceServerScope
Name is required, min 1 max 80 characters, allowed characters: [A-Z,a-z0-9_] Description is optional, if provided must be no longer than 120 characters.
| Name | Description | Schema |
|---|---|---|
description |
Scope description |
string |
name |
Scope name |
string |
AdminOAuthCapabilityDetails
| Name | Description | Schema |
|---|---|---|
accessTokenValiditySeconds |
Access token validity time in seconds |
integer |
allowIntrospection |
Determines if client can make calls to introspection endpoint |
boolean |
applicationType |
Type of OAuth Client application. |
enum (native, web, spa, cli) |
clientDescription |
Client description |
string |
clientId |
Generated identifier of created OAuth client |
string |
clientName |
Name of OAuht client |
string |
contacts |
OAuth client contacts |
< string > array |
defaultMaxAge |
Default maximum session age before re-prompting |
integer |
deviceCodeValiditySeconds |
Device code validity seconds |
integer |
grantTypes |
OAuth grant types. Supported values ["refresh_token", "authorization_code"] |
< string > array |
idTokenValiditySeconds |
id_token validity time in seconds |
integer |
logoUri |
URL of the logo |
string |
redirectUris |
OAuth redirect uris |
< string > array |
refreshTokenValiditySeconds |
Refresh token validity time in seconds |
integer |
requireAuthTime |
Always require that the auth_time claim be sent in the id token |
boolean |
reuseRefreshToken |
Reuse refresh tokens if they are not time |
boolean |
scope |
OAuth client scopes |
< string > array |
subjectType |
Access type parameter |
string |
tokenEndpointAuthMethod |
Authorization method.
Possible values ["SECRET_POST", "SECRET_BASIC", "SECRET_JWT", "PRIVATE_KEY", "NONE"]
SECRET_BASIC value is by default. |
string |
tosUri |
URL for the Terms of Service of this client, will be displayed to the user |
string |
AdminUpdateOAuthCapabilityDetails
| Name | Description | Schema |
|---|---|---|
grantTypes |
OAuth grant types |
< string > array |
scope |
OAuth client scopes |
< string > array |
AliveStatus
| Name | Description | Schema |
|---|---|---|
message |
Description of status if available |
string |
AllResourceServerPermissions
| Name | Description | Schema |
|---|---|---|
appId |
appId |
string |
permissions |
< permissions > array |
|
prefix |
Permission name with prefix |
string |
permissions
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
name |
Permission name |
string |
Application
| Name | Description | Schema |
|---|---|---|
capabilities |
Names of capabilities used in application |
< string > array |
customer |
Id of the customer that application belongs to |
string |
description |
Description of application |
string |
id |
Unique identifier of created application |
string |
isSystem |
True if application is default Resource Server |
boolean |
name |
Name of application |
string |
owner |
Id of the owner that application belongs to |
string |
ApplicationCreated
| Name | Description | Schema |
|---|---|---|
uuid |
Unique identifier of created application |
string |
ApplicationMicroservice
| Name | Description | Schema |
|---|---|---|
appId |
Identifier of application |
string |
microserviceId |
Identifier of microservice |
string |
ApplicationMicroservices
| Name | Schema |
|---|---|
applicationMicroservices |
< applicationMicroservices > array |
applicationMicroservices
| Name | Description | Schema |
|---|---|---|
appId |
Identifier of application |
string |
microserviceId |
Identifier of microservice |
string |
ApplicationType
| Name | Description | Schema |
|---|---|---|
applicationType |
Application type |
string |
Applications
| Name | Schema |
|---|---|
applications |
< applications > array |
applications
| Name | Description | Schema |
|---|---|---|
capabilities |
Names of capabilities used in application |
< string > array |
customer |
Id of the customer that application belongs to |
string |
description |
Description of application |
string |
id |
Unique identifier of created application |
string |
isSystem |
True if application is default Resource Server |
boolean |
name |
Name of application |
string |
owner |
Id of the owner that application belongs to |
string |
CreateApplication
| Name | Description | Schema |
|---|---|---|
description |
Description of application |
string |
name |
Name of application |
string |
CreatePermission
| Name | Description | Schema |
|---|---|---|
description |
Description of permission |
string |
name |
Name of permission. Only [A-Za-z0-9-_]+ characters are allowed. |
string |
CustomerRSScope
| Name | Schema |
|---|---|
description |
string |
name |
string |
CustomerRSScopes
| Name | Schema |
|---|---|
appId |
string |
prefix |
string |
scopes |
< scopes > array |
scopes
| Name | Schema |
|---|---|
description |
string |
name |
string |
CustomerResourceServerScopes
| Name | Schema |
|---|---|
scopes |
< scopes > array |
scopes
| Name | Schema |
|---|---|
appId |
string |
prefix |
string |
scopes |
< scopes > array |
scopes
| Name | Schema |
|---|---|
description |
string |
name |
string |
Error
| Name | Description | Schema |
|---|---|---|
code |
Unique internal error code |
string |
details |
Optional details |
object |
message |
Description of the error code |
string |
ImportOAuthClient
| Name | Description | Schema |
|---|---|---|
description |
Description of application |
string |
grantTypes |
OAuth client grant types |
< string > array |
name |
Name of application |
string |
redirectUris |
OAuth client redirect uris |
< string > array |
scopes |
OAuth client scopes |
< string > array |
uuid |
Unique identifier of application |
string |
ImportResourceServer
| Name | Description | Schema |
|---|---|---|
description |
Description of application |
string |
name |
Name of application |
string |
prefix |
Resource Server prefix |
string |
scopes |
< scopes > array |
|
uuid |
Unique identifier of application |
string |
scopes
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
externalId |
Permission external id |
string |
name |
Permission name |
string |
policy |
Authz policy |
string |
prefix |
Permission prefix |
string |
ImportResourceServerScope
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
externalId |
Permission external id |
string |
name |
Permission name |
string |
policy |
Authz policy |
string |
prefix |
Permission prefix |
string |
Jwt
| Name | Schema |
|---|---|
content |
content
| Name | Description | Schema |
|---|---|---|
customer |
Customer id of authenticated user |
string |
uuid |
Uuid of authenticated user |
string |
ListOfUserPermissions
| Name | Description | Schema |
|---|---|---|
permissions |
Example : |
< string > array |
MicroserviceApp
| Name | Description | Schema |
|---|---|---|
appId |
Unique identifier of created application |
string |
microserviceId |
Microservice identifier |
string |
MicroserviceId
| Name | Description | Schema |
|---|---|---|
id |
Identifier of microservice |
string |
OAuthCapabilityAdded
| Name | Description | Schema |
|---|---|---|
accessTokenValiditySeconds |
Access token validity time in seconds |
integer |
allowIntrospection |
Determines if client can make calls to introspection endpoint |
boolean |
clientDescription |
Client description |
string |
clientId |
Generated identifier of created OAuth client |
string |
clientName |
Name of OAuht client |
string |
clientSecret |
OAuth client secret.
If not provided then will be generated |
string |
contacts |
OAuth client contacts |
< string > array |
defaultMaxAge |
Default maximum session age before re-prompting |
integer |
deviceCodeValiditySeconds |
Device code validity seconds |
integer |
grantTypes |
OAuth grant types. Supported values ["refresh_token", "authorization_code"] |
< string > array |
id |
Internal OIDC unique identifier of OAuth client |
integer |
idTokenValiditySeconds |
id_token validity time in seconds |
integer |
logoUri |
URL of the logo |
string |
redirectUris |
OAuth redirect uris |
< string > array |
refreshTokenValiditySeconds |
Refresh token validity time in seconds |
integer |
requireAuthTime |
Always require that the auth_time claim be sent in the id token |
boolean |
reuseRefreshToken |
Reuse refresh tokens if they are not time out |
boolean |
scope |
OAuth client scopes |
< string > array |
subjectType |
Access type parameter |
string |
tokenEndpointAuthMethod |
Authorization method.
Possible values ["SECRET_POST", "SECRET_BASIC", "SECRET_JWT", "PRIVATE_KEY", "NONE"]
SECRET_BASIC value is by default. |
string |
tosUri |
URL for the Terms of Service of this client, will be displayed to the user |
string |
OAuthCapabilityDetails
| Name | Description | Schema |
|---|---|---|
accessTokenValiditySeconds |
Access token validity time in seconds |
integer |
allowIntrospection |
Determines if client can make calls to introspection endpoint |
boolean |
applicationType |
Type of OAuth Client application. |
enum (native, web, spa, cli) |
clientDescription |
Client description |
string |
clientId |
Generated identifier of created OAuth client |
string |
clientName |
Name of OAuht client |
string |
clientSecret |
OAuth client secret.
If not provided then will be generated |
string |
contacts |
OAuth client contacts |
< string > array |
defaultMaxAge |
Default maximum session age before re-prompting |
integer |
deviceCodeValiditySeconds |
Device code validity seconds |
integer |
grantTypes |
OAuth grant types. Supported values ["refresh_token", "authorization_code"] |
< string > array |
id |
Internal OIDC unique identifier of OAuth client |
integer |
idTokenValiditySeconds |
id_token validity time in seconds |
integer |
logoUri |
URL of the logo |
string |
redirectUris |
OAuth redirect uris |
< string > array |
refreshTokenValiditySeconds |
Refresh token validity time in seconds |
integer |
requireAuthTime |
Always require that the auth_time claim be sent in the id token |
boolean |
reuseRefreshToken |
Reuse refresh tokens if they are not time |
boolean |
scope |
OAuth client scopes |
< string > array |
subjectType |
Access type parameter |
string |
tokenEndpointAuthMethod |
Authorization method.
Possible values ["SECRET_POST", "SECRET_BASIC", "SECRET_JWT", "PRIVATE_KEY", "NONE"]
SECRET_BASIC value is by default. |
string |
tosUri |
URL for the Terms of Service of this client, will be displayed to the user |
string |
OAuthClientImported
| Name | Description | Schema |
|---|---|---|
clientId |
OAuth client id |
string |
clientSecret |
OAuth client secret |
string |
uuid |
Unique identifier of application |
string |
OAuthClientSecret
| Name | Description | Schema |
|---|---|---|
clientSecret |
Generated OAuth client secret |
string |
OAuthClientSelfRegister
| Name | Description | Schema |
|---|---|---|
appDescription |
Description of application |
string |
appName |
Name of application |
string |
appUuid |
Uuid of application |
string |
grantTypes |
OAuth client grant types |
< string > array |
ownerIdentifier |
Identifier of application owner |
string |
redirectUris |
OAuth client redirect uris |
< string > array |
scopes |
OAuth client scopes |
< string > array |
PermissionCreated
| Name | Description | Schema |
|---|---|---|
appId |
Identifier of application |
string |
description |
Permission description |
string |
externalId |
External identifier |
string |
name |
Permission name |
string |
PermissionWithDescription
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
name |
Permission name |
string |
RegisterResourceServer
| Name | Description | Schema |
|---|---|---|
prefix |
Unique short human readable id of the application. Only [A-Za-z0-9-_]+ characters are allowed. |
string |
ResourceServer
| Name | Description | Schema |
|---|---|---|
description |
Description of application |
string |
isSystem |
Is system resource server boolean flag |
boolean |
name |
Name of application |
string |
prefix |
Unique short human readable id of the application |
string |
uuid |
Uuid of application |
string |
ResourceServerApp
| Name | Description | Schema |
|---|---|---|
customer |
Id of the customer that application belongs to |
string |
description |
Description of application |
string |
name |
Name of application |
string |
owner |
Id of the owner that application belongs to |
string |
prefix |
Unique short human readable id of the application |
string |
uuid |
Uuid of application |
string |
ResourceServerCapabilityAdded
| Name | Description | Schema |
|---|---|---|
accessTokenValiditySeconds |
Access token validity time in seconds |
integer |
clientDescription |
Client description |
string |
clientId |
Generated identifier of created OAuth client |
string |
clientName |
Name of OAuht client |
string |
clientSecret |
OAuth client secret.
If not provided then will be generated |
string |
contacts |
OAuth client contacts |
< string > array |
defaultMaxAge |
Default maximum session age before re-prompting |
integer |
deviceCodeValiditySeconds |
Device code validity seconds |
integer |
grantTypes |
OAuth grant types. Supported values ["refresh_token", "authorization_code"] |
< string > array |
id |
Internal OIDC unique identifier of OAuth client |
integer |
idTokenValiditySeconds |
id_token validity time in seconds |
integer |
logoUri |
URL of the logo |
string |
redirectUris |
OAuth redirect uris |
< string > array |
refreshTokenValiditySeconds |
Refresh token validity time in seconds |
integer |
requireAuthTime |
Always require that the auth_time claim be sent in the id token |
boolean |
reuseRefreshToken |
Reuse refresh tokens if they are not time out |
boolean |
scope |
OAuth client scopes |
< string > array |
subjectType |
Access type parameter |
string |
tokenEndpointAuthMethod |
Authorization method.
Possible values ["SECRET_POST", "SECRET_BASIC", "SECRET_JWT", "PRIVATE_KEY", "NONE"]
SECRET_BASIC value is by default. |
string |
tosUri |
URL for the Terms of Service of this client, will be displayed to the user |
string |
ResourceServerImported
| Name | Description | Schema |
|---|---|---|
clientId |
OAuth client id |
string |
clientSecret |
OAuth client secret |
string |
uuid |
Unique identifier of application |
string |
ResourceServerPermission
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
name |
Permission name |
string |
nameWithPrefix |
Permission name with prefix |
string |
ResourceServerPermissions
| Name | Schema |
|---|---|
resourceServerPermissions |
< resourceServerPermissions > array |
resourceServerPermissions
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
name |
Permission name |
string |
nameWithPrefix |
Permission name with prefix |
string |
ResourceServerPermissionsForCustomer
| Name | Schema |
|---|---|
permissions |
< permissions > array |
permissions
| Name | Description | Schema |
|---|---|---|
appId |
appId |
string |
permissions |
< permissions > array |
|
prefix |
Permission name with prefix |
string |
permissions
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
name |
Permission name |
string |
ResourceServerScope
| Name | Description | Schema |
|---|---|---|
description |
scope description |
string |
name |
scope name |
string |
nameWithPrefix |
scope name with prefix |
string |
policy |
policy indicating wheather scope should be enabled / disabled on consent page |
string |
ResourceServerScopeCreated
Name is required, min 1 max 80 characters, allowed characters: [A-Z,a-z0-9_] Description is optional, if provided must be no longer than 120 characters.
| Name | Description | Schema |
|---|---|---|
description |
Scope description |
string |
name |
Scope name |
string |
nameWithPrefix |
Scope name with prefix |
string |
policy |
Policy |
string |
ResourceServerScopes
| Name | Schema |
|---|---|
scopes |
< scopes > array |
scopes
| Name | Description | Schema |
|---|---|---|
description |
scope description |
string |
name |
scope name |
string |
nameWithPrefix |
scope name with prefix |
string |
policy |
policy indicating wheather scope should be enabled / disabled on consent page |
string |
ResourceServerSelfRegister
| Name | Description | Schema |
|---|---|---|
application |
||
capabilities |
Resource server capabilities |
< string > array |
application
| Name | Description | Schema |
|---|---|---|
appDescription |
Description of application |
string |
appName |
Name of application |
string |
appUuid |
Uuid of application |
string |
ownerIdentifier |
Identifier of application owner |
string |
prefix |
Resource server prefix |
string |
scopes |
Resource server scopes |
< scopes > array |
scopes
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
externalId |
Permission external id |
string |
name |
Permission name |
string |
policy |
Authz policy |
string |
prefix |
Permission prefix |
string |
ResourceServerSelfRegisterApplication
| Name | Description | Schema |
|---|---|---|
appDescription |
Description of application |
string |
appName |
Name of application |
string |
appUuid |
Uuid of application |
string |
ownerIdentifier |
Identifier of application owner |
string |
prefix |
Resource server prefix |
string |
scopes |
Resource server scopes |
< scopes > array |
scopes
| Name | Description | Schema |
|---|---|---|
description |
Permission description |
string |
externalId |
Permission external id |
string |
name |
Permission name |
string |
policy |
Authz policy |
string |
prefix |
Permission prefix |
string |
UpdateApplication
| Name | Description | Schema |
|---|---|---|
description |
Description of application |
string |
name |
Name of application |
string |
UpdateOAuthCapabilityDetails
| Name | Description | Schema |
|---|---|---|
allowIntrospection |
Determines if client can make calls to introspection endpoint |
boolean |
clientDescription |
Client description |
string |
contacts |
OAuth client contacts |
< string > array |
defaultMaxAge |
Default maximum session age before re-prompting |
integer |
deviceCodeValiditySeconds |
Device code validity seconds |
integer |
grantTypes |
OAuth grant types. Supported values ["refresh_token", "authorization_code"] |
< string > array |
logoUri |
URL of the logo |
string |
redirectUris |
OAuth redirect uris |
< string > array |
requireAuthTime |
Always require that the auth_time claim be sent in the id token |
boolean |
reuseRefreshToken |
Reuse refresh tokens if they are not time out |
boolean |
scope |
OAuth client scopes |
< string > array |
subjectType |
Access type parameter |
string |
tokenEndpointAuthMethod |
Authorization method.
Possible values ["SECRET_POST", "SECRET_BASIC", "SECRET_JWT", "PRIVATE_KEY", "NONE"]
SECRET_BASIC value is by default. |
string |
tosUri |
URL for the Terms of Service of this client, will be displayed to the user |
string |
UserPermissions
| Name | Schema |
|---|---|
permissions |
< permissions > array |
permissions
| Name | Schema |
|---|---|
appId |
string |
permissions |
< string > array |
prefix |
string |
UserRSPermisions
| Name | Schema |
|---|---|
appId |
string |
permissions |
< string > array |
prefix |
string |
Security
oauth2_implicit
Type : oauth2
Flow : implicit
Token URL : https://cloudentity.dev.cloudentity.com/oauth/authorize
oauth2_authorizationCode
Type : oauth2
Flow : accessCode
Token URL : https://cloudentity.dev.cloudentity.com/oauth/authorize
Token URL : https://cloudentity.dev.cloudentity.com/oauth/token
oauth2_password
Type : oauth2
Flow : password
Token URL : https://cloudentity.dev.cloudentity.com/oauth/token
SsoToken
Type : apiKey
Name : token
In : HEADER