Crear un ámbito personalizado de OAuth
Para definir permisos acerca de los datos a los que una aplicación cliente externa puede acceder desde una entidad externa, cree un ámbito personalizado de OAuth en Salesforce. El ámbito personalizado indica a la entidad externa a qué información está autorizada la aplicación cliente externa para acceder.
Ediciones necesarias
| Disponible en: Salesforce Classic y Lightning Experience |
Las aplicaciones cliente externas se pueden crear en: Group Edition, Essentials Edition, Professional Edition, Enterprise Edition, Performance Edition, Unlimited Edition y Developer Edition Las aplicaciones cliente externas se pueden instalar en: todas las ediciones |
| Permisos de usuario necesarios | |
|---|---|
| Para gestionar, crear, modificar y eliminar aplicaciones OAuth: | Gestionar aplicaciones cliente externas |
El ámbito personalizado de OAuth que crea en su organización de Salesforce corresponde a una política que define en su entidad externa y asigna al recurso.
Por ejemplo, desea crear una aplicación web personalizada que puede acceder a datos del estado de pedido del cliente en su API de estado de pedido. En Salesforce, crea un ámbito personalizado de OAuth order_status. Usted asigna el ámbito personalizado de Salesforce a la aplicación cliente externa que está solicitando acceso a la API de estado de pedido. A continuación define una política order_status en su entidad externa. Esta entidad permite el acceso a datos de estado de pedido del cliente en la API de su sistema de pedidos. Cuando la entidad externa recibe la solicitud de la aplicación cliente externa para acceder al estado del pedido de un cliente, valida el token de acceso de la aplicación cliente externa y el ámbito order_status. Con una validación exitosa, la aplicación puede acceder a información del estado de pedido del cliente en la API del sistema de pedidos.
- En Configuración, ingrese Ámbitos personalizados en el cuadro Búsqueda rápida y, a continuación, seleccione Ámbitos personalizados de OAuth.
- Haga clic en Nuevo ámbito personalizado.
-
Ingrese el nombre del ámbito personalizado. Cuando defina la política correspondiente en su entidad externa, asígnele el nombre exacto como el ámbito personalizado.
El nombre del ámbito personalizado debe ser exclusivo y comenzar con una letra. Incluya únicamente caracteres alfanuméricos y guiones bajos. No puede utilizar espacios en nombres de ámbito personalizado.
-
Ingrese una descripción de los datos protegidos a los que el ámbito permite acceder. La descripción debe ser exclusiva, incluir solo caracteres alfanuméricos y no ser de más de 60 caracteres.
Puede ingresar una etiqueta personalizada en lugar de una descripción. Una ventaja de las etiquetas personalizadas es que puede mantener texto reutilizable en una única ubicación y traducir el texto a varios idiomas. Consulte Etiquetas personalizadas.
Nota Los mismos requisitos de formato de descripción se aplican a las etiquetas personalizadas asociadas con ámbitos personalizados.Las descripciones de ámbito personalizado y las etiquetas personalizadas aparecen en la página de aprobación de OAuth cuando un usuario aprueba la aplicación cliente externa a la que está asignado el ámbito personalizado. -
Para incluir el ámbito personalizado en el extremo de descubrimiento (
https://<your_domain_name>.my.salesforce.com/.well-known/openid-configuration) de OpenID Connect de la aplicación cliente externa, seleccione Incluir en extremo conocido.
