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