Legacy | Change Authentication (for SSO)
Note:
External authentication is only used for SSO-enabled clouds.
Request syntax
There are two ways to use this API:
Copy
Change the user authentication to internal
https://mycloud.perfectomobile.com/services/users/<user-id>?operation=update&securityToken=value&authentication=internal
Copy
Change the user authentication to external (SSO)
https://mycloud.perfectomobile.com/services/users/<user-id>?operation=update&securityToken=value&authentication=external
Parameters
Name | Type | Default | Description |
---|---|---|---|
securityToken* | string |
|
A unique cryptographic key assigned to an authorized user. |
user | string |
|
Deprecated. The name of the user running the operation. Important: All REST API commands require authentication through the Perfecto security token. See also Authentication in new APIs.
|
password | string |
|
Deprecated. The password for the user. Important: All REST API commands require authentication through the Perfecto security token. See also Authentication in new APIs.
|
user-id | string |
|
Target user. |
admin | boolean | false | true to allow users with administrative credentials to change the password for users in their group. |
responseFormat | string | json | The response format: Either json or xml |
* Mandatory parameter
Response
Name | Description |
---|---|
status | success if the operation completed successfully; otherwise failure. |
Examples
This example shows the request for changing the authentication for user JohnSmith@JohnSmith.com, to Internal user.
Copy
Request
https://mycloud.perfectomobile.com/services/users/JohnSmith@JohnSmith.com?operation=update&securityToken=<your_token>&authentication=internal
This example shows the request for changing the authentication for user JohnSmith@JohnSmith.com, to External user.
Copy
Request
https://mycloud.perfectomobile.com/services/users/JohnSmith@JohnSmith.com?operation=update&securityToken=<your_token>&authentication=external