Para obtener más información sobre las relaciones entre objetos y cómo utilizarlas en la API, ve a la sección Relaciones entre objetos .
Para obtener más información sobre las credenciales, visita la página de ayuda Credenciales .
Para recuperar todos los registros de credenciales accesibles, utiliza el punto de conexión
GET {baseURL}/v3/credentials
.
Nota
Si no eres un administrador, los resultados se limitan a credenciales a las que tienes acceso, y los parámetros view, userId y userGroupId no se tendrán en cuenta.
view (cadena): opcional. Se puede dejar sin un valor. Puedes elegir entre los siguientes valores: “Default" (predeterminado) y "Full" (completo). Si este parámetro se define como “Default" (predeterminado), entonces se devolverá un objeto de vista reducida. Cuando no se especifica, se utiliza el valor “Default" (predeterminado).
userId (cadena): opcional. Para filtrar los resultados por userId, ingresa el ID de un usuario.
userGroupId (cadena): opcional. Para filtrar los resultados por userGroupId, ingresa el ID de un grupo de usuarios.
Para obtener detalles sobre una credencial existente, utiliza el punto de conexión
GET {baseURL}/v3/credentials/{credentialId}
.
credentialId (cadena): obligatorio. Ingresa un ID de colección para obtener información acerca de una credencial específica.
To create a credential record, use the POST {baseURL}/v3/credentials endpoint.
Nota
Only Curators can use this API endpoint.
This API endpoint is disabled if TLS is not enabled.
The API validates the username and password and only creates credentials for existing Windows logins with valid passwords.
addContract (body): Required. Specify the following to create a new credential:
password (string) Required. Specify the password for the username of the new credential to be added.
username (string) Required. Specify the username of the new credential to be added.
To update a credential record, use the PUT {baseURL}/v3/credentials/{credentialId} endpoint.
Nota
Only Curators can use this API endpoint.
This API endpoint is disabled if TLS is not enabled.
This API endpoint validates the username and password and only updates credentials for existing Windows logins with valid passwords.
updateContract (body): Required. Specify the following to update a credential with a new password:
NewPassword (string): Required. Specify the new password for the credential ID.
credentialId (string) Required. Enter the ID of the credential to update.
Para compartir una credencial existente con un usuario existente, utiliza el punto de conexión
POST {baseURL}
/v3/credentials/{credentialId}/users
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
credentialId (cadena): obligatorio. Ingresa un ID de colección que desees compartir.
contract (cuerpo): obligatorio. Especifica lo siguiente para compartir una credencial con un usuario:
userId (cadena): obligatorio. Especifica el ID de un usuario con el que deseas compartir una credencial.
Para compartir una credencial existente con un grupo de usuarios existente, utiliza el punto de conexión
POST {baseURL}
/v3/credentials/{credentialId}/userGroups
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
credentialId (cadena): obligatorio. Ingresa un ID de credencial que desees compartir.
contract (cuerpo): obligatorio. Especifica lo siguiente para compartir una credencial con un grupo de usuarios:
userGroupId (cadena): obligatorio. Especifica el ID de un grupo de usuarios con el que desees compartir una credencial.
A fin de quitar el permiso de un usuario para usar una credencial existente, utiliza el punto de conexión
DELETE {baseURL}/v3/credentials/{credentialId}/users/{userId}
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
credentialId (cadena): obligatorio. Ingresa el ID de credencial del que deseas quitar el usuario.
userId (cadena): obligatorio. Ingresa un ID de usuario que desees quitar de la credencial.
A fin de quitar el permiso de un grupo de usuarios para usar una credencial existente, utiliza el punto de conexión
DELETE {baseURL}/v3/credentials/{credentialId}/userGroups/{userGroupId}
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
credentialId (cadena): obligatorio. Ingresa el ID de credencial del que deseas quitar el grupo de usuarios.
userGroupId (cadena): obligatorio. Ingresa un ID de grupo de usuarios que desees quitar de la credencial.
Para eliminar una credencial existente, utiliza el punto de conexión
DELETE {baseURL}/v3/credentials/{credentialId}
.
Nota
Solo los administradores pueden usar este punto de conexión de la API.
credentialId (cadena): obligatorio. Ingresa el ID de credencial que deseas eliminar.
force (booleano): opcional. Selecciona si deseas forzar la eliminación de una credencial en caso de que haya algún recurso compartido. Si deseas eliminar la credencial y limpiar todos los recursos compartidos, establece el parámetro force en verdadero. Si no se selecciona, el valor predeterminado es falso. Esto es para protegerse contra una llamada errante.
Para obtener información sobre los ID de credencial existentes, utiliza el punto de conexión GET /v3/credentials . El credentialId que obtienes se puede utilizar en las siguientes situaciones:
Cuando deseas obtener información sobre una credencial específica .
Cuando deseas compartir una credencial con un usuario .
Cuando deseas compartir una credencial con un grupo de usuarios .
Cuando deseas quitar un usuario de una credencial .
Cuando deseas quitar un grupo de usuarios de una credencial .
Cuando deseas eliminar una credencial específica .
You want to update a specific credential.