...
Formatting specifications for each web service, including details about parameter requirements, are provided.
Create an OAuth Client
| Description |
---|
URI | http://host_name/uc/resources/oauthclient |
HTTP Method | POST |
Description | Creates an OAuth Client. |
Example URI | http://localhost:8080/uc/resources/oauthclient |
Authentication | HTTP Basic |
Produces Content-Type | n/a |
Consumes Content-Type | application/xml, application/json |
Example Responses | Status 200 Status 400 Status 403 Status 404 Status 500
|
OAuth Client Properties
Property | UI Field Name | Description | Specifications | Required |
---|
authorizationEndpoint
| Authorization Endpoint | The authorization endpoint for the authorization server. |
| Y |
clientId
| Client ID | The Client ID issued by the authorization server. |
| Y |
clientSecret
| Client Secret | The Client secret issued by the authorization server. |
| Y |
clusterRedirectUrls
| Cluster Node Redirect URLs | List of Redirect URLS. XML <clusterRedirectUrls>
<clusterRedirectUrl>
<clusterNode>node1:8080-uc</clusterNode>
<redirectUrl>http://localhost:8080/uc/oauth2/callback</redirectUrl>
</clusterRedirectUrl>
</clusterRedirectUrls>
JSON "clusterRedirectUrls": [
{
"clusterNode": "node1:8080-uc",
"redirectUrl": "http://localhost:8080/uc/oauth2/callback"
}
]
|
| N |
description
| Description | Description of this record. |
| N |
exportReleaseLevel
| n/a | Universal Controller release that the record was exported from. | read only | N |
exportTable
| n/a | Record table information. | read only | N |
name
| Name | Name used within the Controller to identify this OAuth Client. | Maximum 100 alphanumerics. | Y |
opswiseGroups
| Member of Business Services | List of Business Services: XML <opswiseGroups>
<opswiseGroup>test</opswiseGroup>
</opswiseGroups>
JSON "opswiseGroups": [
"test"
]
|
| N |
provider
| Provider | The authentication server provider. | Valid Values: As String = Azure AD, As Value = 1 As String = Google, As Value = 2 As String = Other, As Value = 3
| Y |
retainSysIds
| n/a | Specification for whether or not the Create an OAuth Client web service will persist the sysId property. If retainSysIds="true" and sysId is included in the request/response, sysId will be persisted to the database. If retainSysIds="false" and sysId is included in the request/response, sysId will be ignored; it will be autogenerated by the Controller.
Note In XML web services, retainSysIds is specified as an attribute in the <calendar> element. | Valid values: true/false (default is true). | N |
scopes
| Scopes | List of scopes to request access to. XML <scopes>
<scope>https://mail.google.com</scope>
</scopes>
JSON "scopes": [
"https://mail.google.com"
]
|
| Y |
sysId
| UUID | System ID field in the database for this OAuth Client record. | Persisted only if retainSysIds is set to true. | N |
tokenEndpoint
| Token Endpoint | The token endpoint for the authorization server. |
| Y |
Create an OAuth Client: XML and JSON Examples
XML | JSON |
---|
Expand |
---|
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<oauthClient retainSysIds="true">
<authorizationEndpoint>https://accounts.google.com/o/oauth2/v2/auth</authorizationEndpoint>
<clientId>client_id</clientId>
<clientSecret>client_secret</clientSecret>
<clusterRedirectUrls>
<clusterRedirectUrl>
<clusterNode>node1:8080-uc</clusterNode>
<redirectUrl>http://localhost:8080/uc/oauth2/callback</redirectUrl>
</clusterRedirectUrl>
</clusterRedirectUrls>
<description>description</description>
<name>Google</name>
<opswiseGroups/>
<provider>Google</provider>
<scopes>
<scope>https://mail.google.com</scope>
</scopes>
<sysId>239119555c2c427f8f5b29faeecfdc27</sysId>
<tokenEndpoint>https://oauth2.googleapis.com/token</tokenEndpoint>
</oauthClient>
|
| Expand |
---|
|
{
"authorizationEndpoint": "https://accounts.google.com/o/oauth2/v2/auth",
"clientId": "client_id",
"clientSecret": "client_secret","
"clusterRedirectUrls": [
{
"clusterNode": "node1:8080-uc",
"redirectUrl": "htttp://localhost:8080/uc/oauth2/callback"
}
],
"description": "description",
"name": "Google OAuth Client",
"opswiseGroups": [],
"provider": "Google",
"retainSysIds": true,
"scopes": [
"https://mail.google.com"
],
"sysId": "239119555c2c427f8f5b29faeecfdc27",
"tokenEndpoint": "https://oauth2.googleapis.com/token",
}
|
|