Crea un cliente OAuth

Este procedimiento es para proveedores de aplicaciones que desean que su aplicación reciba un token que le permita realizar solicitudes a Genesys Cloud. Plataforma API. El token representa el permiso de un usuario para que la aplicación acceda a los datos de Genesys Cloud. Se utiliza cuando la aplicación debe autorizar una solicitud a un punto final de la API. Para ver una lista de las API de Genesys Cloud Platform, consulte la Recursos de la API en el Centro de desarrolladores de Genesys Cloud.

1. Hacer clic Administración.
2. Debajo Integraciones, haga clic en OAuth.

3. Hacer clic Agregar cliente. Aparece la pestaña Detalles del cliente.

   
4. Colocar Nombre de la aplicación a un nombre descriptivo de la aplicación. Este nombre se muestra cuando alguien autoriza este cliente OAuth.
5. (Opcional) Escriba una breve descripción de la aplicación en el Descripción caja.
6. A continuación, establezca la duración del tiempo hasta que caduquen los tokens creados con este cliente. Acepte la duración predeterminada o ingrese un valor entre 300 y 172800 segundos. Esto establece la vida útil del token en un máximo de 2 días o menos.
   Nota: Cuando el cumplimiento de la HIPAA está habilitado para su organización, Genesys Cloud aplica un tiempo de espera de 15 minutos y este tiempo de espera también se aplica a los tokens emitidos por los clientes de OAuth. Para más información, ver Cumplimiento de HIPAA.

7. Haga una selección a continuación Tipos de subvenciones. Los tipos de concesión establecen la forma en que una aplicación obtiene un token de acceso. Genesys Cloud admite los tipos de concesión de autorización OAuth 2 que se enumeran a continuación. Al hacer clic en el nombre de un tipo de subvención, se muestra más información al respecto de el Centro de desarrolladores de Genesys Cloud.

   • Concesión de credenciales de cliente: Un proceso de autenticación de un solo paso para uso exclusivo de aplicaciones que no son de usuario (por ejemplo, un servicio de Windows o un trabajo cron). La aplicación cliente proporciona credenciales de cliente OAuth a cambio de un token de acceso. Este tipo de autorización no está en el contexto de un usuario y, por lo tanto, no podrá acceder a las API específicas del usuario (por ejemplo, GET / v2 / users / me).

     Si asigna roles para Genesys Cloud for Salesforce, consulte también Permisos de cliente de OAuth para Genesys Cloud para Salesforce.

   • Concesión de autorización de código: Un proceso de autenticación de dos pasos en el que un usuario se autentica con Genesys Cloud, luego la aplicación cliente recibe un código de autorización. La aplicación cliente proporciona credenciales de cliente OAuth y utiliza el código de autorización para obtener un token de acceso. El token de acceso se puede utilizar al realizar llamadas API autenticadas. Esta es la opción más segura e ideal para sitios web donde las solicitudes de API se realizarán en el lado del servidor (por ejemplo, ASP.NET o PHP) y algunas aplicaciones de escritorio donde un cliente ligero autorizaría al usuario y pasaría el código de autenticación a un servidor back-end. para intercambiar por un token de autenticación y realizar solicitudes de API.

   • Concesión implícita (navegador): Un proceso de autenticación de un solo paso en el que un usuario se autentica con Genesys Cloud y la aplicación cliente recibe directamente un token de acceso. Esta opción proporciona menos seguridad para el token de acceso que la concesión del código de autorización, pero es ideal para aplicaciones de navegador del lado del cliente (es decir, JavaScript) y la mayoría de las aplicaciones de escritorio (por ejemplo, .NET WPF / WinForms o programas de escritorio Java).

   • Portador SAML2: Un proceso de autenticación en el que una aplicación cliente puede utilizar una aserción de Lenguaje de marcado de aserción de seguridad (SAML2) para solicitar un token de portador. Ver también: Solución de proveedor de identidad e inicio de sesión único de Genesys Cloud.
     
     

     Nota: Se puede utilizar un único tipo de autorización de código o concesión implícita en todas las regiones.

8. Proporcione los parámetros requeridos por el tipo de subvención.

   • Roles: Si seleccionaste Credenciales de cliente, haga clic en el Roles pestaña. Esto abre una lista de roles para elegir. Asigne un conjunto mínimo de roles para determinar qué puede hacer su integración de cliente OAuth.
     

     Nota: Para otorgar roles a un cliente OAuth, debe tener esos roles asignados a su perfil.

     

     También debe asociar cada rol con un división. Determine qué divisiones deben asociarse con roles para la concesión de credenciales de cliente. Todos los roles de concesión de credenciales de cliente están asignados a la División de origen de forma predeterminada. Actualice con las divisiones apropiadas para que las aplicaciones y los sistemas que utilizan esas subvenciones puedan acceder a los datos apropiados. Si un tercero proporciona una concesión de credencial de cliente, consulte con el tercero para comprender el uso de la concesión y actualice las divisiones para los roles de manera adecuada. Ningún otro tipo de concesión se ve afectado por el control de acceso.

   • URI de redireccionamiento autorizado (uno por línea, hasta 125): Estos son los URI en los que se publica el código de autorización, que se intercambiarán por un token de acceso que se usará más tarde para autenticar las llamadas API posteriores.

   • Alcance: Todos los tipos de concesión, excepto las Credenciales de cliente, tienen una configuración de Alcance. Haga clic en el cuadro Ámbito para mostrar una lista de los ámbitos disponibles para su aplicación. Como práctica recomendada, seleccione solo los alcances mínimos que necesita su aplicación. Para obtener información sobre los ámbitos, consulte Ámbitos de OAuth en el Centro de desarrolladores. 

9. Hacer clic Ahorrar. Genesys Cloud crea un ID de cliente y un secreto de cliente (token).

Su cliente Genesys Cloud OAuth ya está listo para usar.