Etapa, rotación y eliminación de credenciales de OAuth para una aplicación cliente externa
Utilice el extremo de API de REST de Connect Credenciales por etapas de OAuth para gestionar la clave y el secreto de OAuth para una aplicación cliente externa. La API se puede utilizar para organizar, ver, rotar o eliminar credenciales de OAuth.
Ediciones necesarias
| Disponible en: Lightning Experience. |
| Disponible en: Professional Edition, Performance Edition, Unlimited Edition y Developer Edition |
| Permisos de usuario necesarios | |
|---|---|
| Para organizar, rotar y eliminar credenciales de OAuth. | Desarrollador de aplicación cliente externa y Ver secreto de cliente |
Antes de empezar, asegúrese de que se cumplen estos requisitos previos.
- Debe tener un token de acceso válido.
- Permitir el acceso a secretos de consumidor de aplicación cliente externa a través de API de REST debe activarse en Configuración de aplicación cliente externa.
Este procedimiento utiliza ejemplos de cURL, pero puede utilizar otras herramientas. Para familiarizarse con cURL, consulte Uso de cURL en la Guía del desarrollador de API de REST. Los ejemplos de cURL utilizan texto de marcador de posición para access_token, external_client_app_identifier consumer_id y staged_credential_id. Sustituya estos términos por los valores relevantes para sus credenciales de aplicación cliente externas.
-
Para recuperar el Id. de la aplicación cliente externa, envíe una llamada al extremo de Uso de OAuth.
curl --silent 'https://MyDomainName.my.salesforce.com/services/data/v65.0/ apps/oauth/usage' -H 'Authorization: Bearer access_token' -H 'Accept: application/json' -H 'Content-Type: application/json' | jq .El resultado de esta solicitud incluye un identificador, que se utiliza en la siguiente llamada.
"identifier": "external_client_app_identifier" -
Para recuperar el Id. de recurso organizado, configure la cURL y envíe una llamada al extremo Credenciales de OAuth por Id. de aplicación.
curl --silent 'https://MyDomainName.my.salesforce.com/services/data/v65.0/ apps/oauth/credentials/external_client_app_identifier' -H 'Authorization: Bearer access_token' -H 'Accept:El resultado de esta solicitud incluye una URL de credenciales por etapas, que se utiliza en la siguiente llamada. Incluye el identificador de la primera respuesta y un Id. de consumidor, seguido de
/staged."stagedCredentialsURL": "services/data/v65.0/apps/oauth/ credentials/external_client_app_identifier/consumer_id/staged" -
Para recuperar las credenciales por etapas actuales, configure la cURL y envíe una llamada al extremo de Credenciales por etapas OAuth.
curl --silent 'https://MyDomainName.my.salesforce.com/services/data/v65.0/ apps/oauth/credentials/external_client_app_identifier/consumer_id/staged' -H 'Authorization: Bearer access_token' -H 'Accept: application/json' -H 'Content-Type: application/json' | jq .
Nota El resultado de esta solicitud incluye el estado de la credencial. Las opciones son Activa, Rotada o Vencida. Si hay una credencial por etapas, las credenciales deben rotarse o eliminarse antes de que se puedan organizar nuevas credenciales. Las credenciales por etapas caducan pasados 30 días a menos que se eliminen primero. -
Para organizar credenciales, envíe una llamada POST al extremo de Credenciales por etapas de OAuth.
curl --silent -X POST 'https://MyDomainName.my.salesforce.com/services/ data/v65.0/apps/oauth/credentials/external_client_app_identifier/ consumer_id/staged' -H 'Authorization: Bearer access_token' -H 'Accept: application/json' -H 'Content-Type: application/json' | jq .El resultado de la llamada Credenciales de OAuth incluye una URL que se utiliza en la llamada para rotar o eliminar credenciales por etapas. La URL incluye el identificador de aplicación cliente externa y el Id. de consumidor seguido de /staged y finalmente el Id. de recurso de credenciales por etapas.
"id": "staged_credential_id" -
Para rotar las credenciales por etapas, configure la cURL y envíe una llamada PATCH al extremo Credenciales de OAuth.
curl --silent -X PATCH 'https://MyDomainName.my.salesforce.com/services/ data/v65.0/apps/oauth/credentials/external_client_app_identifier/ consumer_id/staged/staged_credential_id' -H 'Authorization: Bearer access_token' -H 'Content-Type: application/json' -d '{ "command": "rotate" }' | jq . -
Para eliminar las credenciales por etapas, configure la cURL y envíe una llamada DELETE al extremo Id. de credenciales por etapas de OAuth.
curl --silent -X DELETE 'https://MyDomainName.my.salesforce.com/services/ data/v65.0/apps/oauth/credentials/external_client_app_identifier/ consumer_id/staged/staged_credential_id' -H 'Authorization: Bearer access_token' -H 'Accept: application/json' -H 'Content-Type: application/json'
