Autenticación Icertis

Este conector admite dos tipos de autenticación:

• Código de autorización OAuth 2.0 (predeterminado)

• Clave API

Código de autorización OAuth 2.0

El código de autorización OAuth 2.0 es el tipo de autenticación predeterminado para el conector Icertis. Se basa en la configuración de una aplicación OAuth 2.0 en Microsoft Azure.

Requisitos previos

Para utilizar la autenticación de código de autorización OAuth 2.0, necesitas:

• Una licencia o suscripción válida para la plataforma Icertis Contract Intelligence (ICI).
• Una licencia o suscripción válida para Microsoft Azure.

Flujo de autorización

El método de autenticación del código de autorización OAuth 2.0 utiliza el siguiente flujo de autorización:

1. La aplicación cliente solicita un token de acceso JWT para la API de ICI desde el servidor de autorización de Azure.

2. El punto final de emisión del token de Azure valida las credenciales y emite el token de acceso JWT para la API de ICI.

3. A través de HTTPS, la aplicación cliente utiliza el token de acceso JWT devuelto para añadir la cadena JWT con una designación Bearer en el encabezado de Autorización de la solicitud a la API de ICI.

4. El controlador de validación de tokens de ICI valida el token de acceso con el servidor de autorización de Azure.

5. Si la validación del token tiene éxito, ICI configura el contexto de usuario en función de un valor de tipo de reclamación particular asignado a un usuario en el repositorio de ICI y devuelve el recurso deseado en consecuencia. Este usuario puede ser un usuario de servicio o de aplicación.

Configurar una aplicación en Microsoft Azure

Sigue los siguientes pasos para configurar una aplicación ICI en Azure.

1. Inicia sesión en el portal de Microsoft Azure en https://portal.azure.com/. En la página de inicio, selecciona Registros de aplicaciones.
2. En la página Registros de aplicaciones , selecciona Nuevo registro.
3. En la ventana Registrar una aplicación , proporciona los siguientes detalles para la nueva aplicación:
   1. Nombre: API de ICM, por ejemplo.
   2. Tipos de cuenta compatibles: selecciona Cuentas solo en este directorio organizativo (inquilino único).
   3. Proporcione el siguiente URI de redirección web: https://cloud.uipath.com/provisioning_/callback
   4. Selecciona Registrar. La nueva aplicación ya está disponible en la pestaña Registro de aplicaciones : aplicaciones propias.
      
      

      

      
      
4. Selecciona tu aplicación en la página Registros de aplicaciones . La sección Administrar incluye pestañas como Autenticación, Certificados y secretos, Permisos de API , etc. Puedes configurar aún más la aplicación utilizando estas secciones.
5. En la pestaña Autenticación , puedes añadir un nuevo URI de redirección o editar el existente. En Concesión implícita, selecciona Tokens de acceso. Esto habilita el flujo de concesión implícito y selecciona el tipo de token que quieres que emita el token de autorización.
6. A continuación, en Certificados y secretos, selecciona Nuevo secreto de cliente. En la nueva ventana, añade la Descripción del secreto de cliente (por ejemplo: "Secreto de la API de ICM que se utilizará para los tokens de acceso") y selecciona la fecha de caducidad (por ejemplo, un año). Selecciona Añadir para crear el nuevo secreto.

   Copia el secreto de cliente. No compartas este secreto públicamente y guárdalo en una ubicación segura. No podrá recuperarlo más tarde.

7. En Exponer una API, selecciona el botón Establecer junto a URI de ID de aplicación. Se muestra un formulario con un valor predeterminado ya generado. Haz clic en Guardar para guardarlo. El URI del ID de la aplicación utiliza el siguiente formato: api://{Client ID}.
   
   

   

   
   
8. Tu aplicación de Azure ya está configurada con ámbitos y tipos de concesión predeterminados. Si quieres añadir ámbitos personalizados, en Exponer una API, selecciona Añadir un ámbito. Configura el nuevo ámbito y selecciona Añadir ámbito.
   
   

   

   
   

Enviar los detalles de la aplicación a Icertis

Una vez que hayas creado tu aplicación, ponte en contacto con tu administrador de Icertis y proporciónales los siguientes detalles para tus entornos de desarrollo y producción:

Detalles de la aplicación necesarios	Detalles	Comentarios
ID de la aplicación (cliente)	Desarrollador: [Customer to provide] Producción: [Customer to provide]	ID de aplicación para la aplicación creada para acceder a las API de ICI
ID (de tenant) del Directorio	Desarrollador: [Customer to provide] Producción: [Customer to provide]	ID de tenant para la aplicación creada para acceder a las API de ICI
IdDeObjeto	Desarrollador: [Customer to provide] Producción: [Customer to provide]	ID de objeto de la aplicación creada para acceder a las API de ICI
Documento de metadatos de OpenID Connect	Desarrollador: [Customer to provide] Producción: [Customer to provide]	URL del documento de metadatos para la aplicación creada para acceder a las API de ICI

Configuración de ICI

En la plataforma ICI, necesitas una configuración mínima para empezar.

Añade o actualiza las siguientes claves en el archivo tenant.json de la aplicación ICI con la ayuda de tu equipo de desarrolladores de Icertis:

Clave	Valor	Valor JSON
Core.API.OAuth.STSDiscoveryEndpoint	https://login.microsoftonline.com/{Directory (tenant) ID}/v2.0/.well-known/openid-configuration	{ "Id": "1033c3c0-6bf2-4a93-b813-c3ba42a199b3", "IsEncrypted": false, "OverrideType": "Overridable", "ValueType": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089", "Value": "https://login.microsoftonline.com/{Directory (tenant) ID}/v2.0/.well-known/openid-configuration", "Description": "STS Discovery Endpoint URL", "DefaultValue": null, "IsReadOnly": false, "ErrorMessageDescription": null, "Name": "Core.API.OAuth.STSDiscoveryEndpoint" }
Core.API.OAuth.ValidAudiences	api://{Client ID}	{ "Id": "94c37b1b-2fb1-4f4e-a3de-6796279031e6", "IsEncrypted": false, "OverrideType": "Overridable", "ValueType": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089", "Value": " api://{Client ID}", "Description": "Comma separated list of valid audiences", "DefaultValue": null, "IsReadOnly": false, "ErrorMessageDescription": null, "Name": "Core.API.OAuth.ValidAudiences" }
Core.API.OAuth.ValidIssuer	https://sts.windows.net/{Directory (tenant) ID}/	{ "Id": "d469b34c-f89f-42bb-934a-7ee4ef298130", "IsEncrypted": false, "OverrideType": "Overridable", "ValueType": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089", "Value": "https://sts.windows.net/{Directory (tenant) ID}/", "Description": "OAuth Token issuer", "DefaultValue": null, "IsReadOnly": false, "ErrorMessageDescription": null, "Name": "Core.API.OAuth.ValidIssuer" }
Core.API.OAuth.ExternalUpnClaimUri	http://schemas.microsoft.com/identity/claims/objectidentifier	{ "Id": "1e783a54-b564-4748-a088-c04e8e05ab46", "IsEncrypted": false, "OverrideType": "Overridable", "ValueType": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089”, "Value":"http://schemas.microsoft.com/identity/claims/objectidentifier", "Description": "URL of the Claim to be used to uniquely identify user in ICI", "DefaultValue": null, "IsReadOnly": false, "ErrorMessageDescription": null, "Name": "Core.API.OAuth.ExternalUpnClaimUri" }

Donde:

• Core.API.OAuth.STSDiscoveryEndpoint es el valor del documento de metadatos de OpenID Connect que se encuentra en Registro de la aplicación > Información general > Puntos finales.
  
  

  

  
  
• Core.API.OAuth.ValidAudiences es el URI del ID de la aplicación que se encuentra en Registro de la aplicación > Información general.
• Core.API.OAuth.ValidIssuer es el valor de reclamación estándar obtenido de la combinación de iss URL y el ID del directorio (tenant). El iss URL es https://sts.windows.net y el ID del directorio (tenant) está disponible en Registro de la aplicación > Información general.
  
  

  

  
  
• Core.API.OAuth.ExternalUpnClaimUri es la URL de reclamación estándar. ICI utiliza el tipo de reclamación oid con la siguiente URL: http://schemas.microsoft.com/identity/claims/objectidentifier.

Una vez que la configuración esté lista a nivel de ICI, puedes probar la API de ICI con el token de acceso recibido de Azure. Ten en cuenta que ICI solo autoriza los tokens de acceso de los usuarios que están aprovisionados en ICI.

Clave API

El método de autenticación de clave API utiliza un ICMAuthToken para crear una conexión. Utiliza este método de autenticación para validar rápidamente que las API están alojadas correctamente.

El ICMAuthToken se genera para un usuario de la plataforma Icertis Contract Intelligence (ICI) que haya iniciado sesión. Ten en cuenta que puedes configurar explícitamente una fecha de caducidad del token para un usuario.

1. Como usuario de ICI, recupera la clave API navegando a la siguiente URL: https://{{customerinstance}}.icertis.com/userinformation/GetUserApiToken.
2. Utiliza las herramientas de desarrollador de tu navegador para inspeccionar la página y recuperar el UserApiToken.

Añadir la conexión Icertis

1. Selecciona Integration Service de Automation Cloud^TM.

2. En la lista Conectores , selecciona Icertis. También puedes utilizar la barra de búsqueda para acotar el conector.
3. Selecciona el botón Conectar a Icertis . Puedes elegir entre dos tipos de autenticación: código de autorización OAuth 2.0 o clave API.
4. Introduce las credenciales necesarias para tu autenticación preferida:
   1. Código de autorización OAuth 2.0 (predeterminado): ID de cliente, Secreto de cliente, ID de tenant, Ámbito.
   2. Clave API: clave API.
5. Seleccione Conectar.