NetScalercomo proveedor de identidad de OAuth

Ahora se puede configurar un dispositivo NetScaler como proveedor de identidad mediante el protocolo OpenID-Connect (OIDC). El protocolo OIDC refuerza las capacidades de aportación de identidad del dispositivo NetScaler. Ahora puede acceder a la aplicación alojada en toda la empresa con un inicio de sesión único, ya que OIDC ofrece más seguridad al no transferir la contraseña del usuario, sino al usar tokens con una duración específica. OpenID también está diseñado para integrarse con clientes que no son de explorador, como aplicaciones y servicios. Por lo tanto, muchas implementaciones adoptan ampliamente el protocolo OIDC.

Nota

NetScalerdebe tener la versión 12.1 o posterior para que el dispositivo funcione como proveedor de identidad de OAuth mediante el protocolo OIDC.

Ventajas de tener NetScaler como proveedor de identidades de OAuth

• Elimina la sobrecarga de mantener varias contraseñas de autenticación, ya que el usuario tiene una identidad única en toda la organización.
• Proporciona una seguridad sólida para su contraseña, ya que la contraseña solo se comparte con su proveedor de identidad y no con ninguna aplicación a la que accedas.
• Proporcionó una amplia interoperabilidad con varios sistemas, lo que facilita que las aplicaciones alojadas acepten OpenID.

Nota

Se necesitan NetScaler Advanced Edition y versiones posteriores para que la solución funcione.

Para configurar el dispositivo NetScaler como IdP de OAuth mediante la GUI

1. Vaya aConfiguración > Seguridad > Tráfico de aplicaciones AAA > Directivas > Autenticación > Directivas avanzadas > IdP de OAuth.

2. Haga clic enPerfily haga clic enAgregar.

   En la pantallaCrear perfil de proveedor de identidad de OAuth de autenticación, defina los valores para los siguientes parámetros y haga clic enCrear.

   • Nombre: Nombre del perfil de autenticación. Debe comenzar con una letra, un número o un carácter de guión bajo (_) y debe contener solo letras, números y guión (-), punto (.), almohadilla (#), espacio ( ), en (@), igual a (=), dos puntos (:) y guión bajo. No se puede cambiar una vez creado el perfil.

   • Client ID: Cadena única que identifica al proveedor de servicios. El servidor de autorización defiere la configuración del cliente mediante este ID. Longitud máxima: 127.
   • Secreto de cliente: Cadena secreta establecida por el usuario y el servidor de autorización. Longitud máxima: 239.
   • URL de redirección: Punto final del SP en el que se debe publicar el código/token.
   • Nombre del emisor: Identidad del servidor cuyos tokens se van a aceptar. Longitud máxima: 127.
   • Público: Destinatario objetivo del token que envía el IDP. El destinatario podría comprobarlo.
   • Tiempo sesgado: Esta opción especifica el sesgo de reloj permitido en minutos que NetScaler permite en un token entrante. Por ejemplo, si skewTime es 10, el token sería válido desde (tiempo actual - 10) min a (tiempo actual+ 10) min, es decir, 20 min en total. Valor por defecto: 5.
   • Grupo de autenticación predeterminado: Un grupo que se agrega a la lista de grupos internos de la sesión cuando el IdP elige este perfil y que se puede usar en el flujo nFactor. Se puede usar en la expresión (AAA.USER.IS_MEMBER_OF (“xxx”)) para que las directivas de autenticación identificar el flujo de nFactor relacionado con la parte de confianza. Longitud máxima: 63

   A group added to the session for this profile to simplify policy evaluation and help in customizing policies. This is the default group that is chosen when the authentication succeeds in addition to the extracted groups. Maximum Length: 63.

3. Haga clic enDirectivasy enAgregar.

4. En la pantallaCrear directiva de IDP de OAuth de autenticación, defina los valores para los siguientes parámetros y haga clic enCrear.

   • Nombre: Nombre de la directiva de autenticación.
   • Acción: Nombre del perfil creado anteriormente.
   • Acción de registro: Nombre de la acción de registro de mensajes que se utilizará cuando una solicitud coincida con esta directiva. No es un archivo obligatorio.
   • Acción deresultado indefinido: accióna realizar si el resultado de la evaluación de directivas no está definido (UNDEF). No es un campo obligatorio.
   • Expresión: Expresión de directiva avanzada que la directiva utiliza para responder a una solicitud específica. Por ejemplo, true.
   • Comments: Cualquier comentario sobre la directiva.

Enlace de la directiva OAuthIDP y la directiva LDAP al servidor virtual de autenticación

1. Vaya aConfiguración > Seguridad > Tráfico de aplicaciones AAA > Directivas > Autenticación > Directivas avanzadas > Acciones > LDAP.

2. En la pantallaAcciones de LDAP, haga clic enAgregar.

3. En la pantallaCrear servidor LDAP de autenticación, defina los valores de los siguientes parámetros y haga clic enCrear.

   • Nombre:nombre de la acción LDAP
   • ServerName/ServerIP:proporciona FQDN o IP del servidor LDAP
   • Elija los valores adecuadospara Tipo de seguridad, Puerto, Tipo de servidor, Tiempo de espera
   • Asegúrese de quela opción de autenticaciónesté marcada
   • DN base:Base desde la que se inicia la búsqueda LDAP. Por ejemplo, dc=aaa, dc=local.
   • DN de enlace de administrador:nombre de usuario del enlace al servidor LDAP. Por ejemplo, admin@aaa.local.
   • Contraseña de administrador/Confirmar contraseña: Contraseña para enlazar LDAP
   • Haga clic enProbar conexiónpara probar su configuración.
   • Atributo de nombre de inicio de sesión del servidor:elija“sAMAccountName”
   • Otros campos no son obligatorios y, por lo tanto, se pueden configurar según sea necesario.

4. Vaya aConfiguración > Seguridad > Tráfico de aplicaciones AAA > Directivas > Autenticación > Directivas avanzadas > Directiva.

5. En la pantallaDirectivas de autenticación, haga clic enAgregar.

6. En la páginaCrear directiva de autenticación, defina los valores de los siguientes parámetros y haga clic enCrear.

   • Nombre:nombre de la directiva de autenticación LDAP.
   • Tipo de acción:seleccioneLDAP.
   • Acción:seleccione la acción LDAP.
   • Expresión:expresión de directiva avanzada que la directiva utiliza para responder a una solicitud específica. Por ejemplo, true**.

La función OAuth ahora admite las siguientes capacidades en la API de tokens desde el lado de Reliing Party (RP) y desde el lado de IdP de NetScaler Gateway y NetScaler.

• Compatibilidad con PKCE (clave de prueba para intercambio de código)

• Soporte para client_assertion

Para configurar el dispositivo NetScaler como un IdP mediante el protocolo OIDC mediante la CLI

En el símbolo del sistema, escriba los comandos siguientes:

add authentication OAuthIDPProfile  [-clientID ][-clientSecret ][-redirectURL ][-issuer ][-audience ][-skewTime ] [-defaultAuthenticationGroup ] add authentication OAuthIdPPolicy  -rule  [-action  [-undefAction ] [-comment ][-logAction ] add authentication ldapAction aaa-ldap-act -serverIP 10.0.0.10 -ldapBase "dc=aaa,dc=local" ldapBindDn  -ldapBindDnPassword  -ldapLoginName sAMAccountName add authentication policy aaa-ldap-adv-pol -rule true -action aaa-ldap-act bind authentication vserver auth_vs -policy  -priority 100 -gotoPriorityExpression NEXT bind authentication vserver auth_vs -policy  -priority 5 -gotoPriorityExpression END bind vpn global –certkey <> 

Nota:

• Puede enlazar más de una tecla. Las partes públicas de los certificados enlazados se envían en respuesta ajwks\_uri query (https://gw/oauth/idp/certs).

• El dispositivo de punto final introspectivo de IdP de OAuth admite la propiedadactive: true.

Compatibilidad con tokens cifrados en el protocolo OIDC

El dispositivo NetScaler con el mecanismo OIDC ahora admite el envío de tokens cifrados junto con tokens firmados. El dispositivo NetScaler utiliza especificaciones de cifrado web JSON para calcular los tokens cifrados y solo admite la serialización compacta de tokens cifrados. Para cifrar un token OpenID, un dispositivo NetScaler necesita la clave pública de la parte que confía (RP). La clave pública se obtiene dinámicamente sondeando el punto final de configuración conocido de la parte que confía.

Se introduce una nueva opción “relyingPartyMetadataURL” en el perfil “authentication OAuthIDPProfile”.

Para configurar el punto final de la parte de confianza mediante la CLI

En la línea de comandos, escriba:

```set authentication OAuthIDPProfile [-relyingPartyMetadataURL ] [-refreshInterval ] [-status < >]

- **relyingPartyMetadataURL**: Dispositivo de punto final en el que el proveedor de identidades de NetScaler puede obtener detalles sobre la parte que confía que se está configurando. La respuesta de metadatos debe incluir dispositivos de punto final para jwks_uri para claves públicas de RP. - **refreshInterval**: Define la velocidad a la que se debe sondear este extremo para actualizar los certificados en minutos. - **status**: Refleja el estado de la operación de sondeo. El estado se completa una vez que el dispositivo NetScaler obtiene correctamente las claves públicas. **Ejemplo** ``` set authentication OAuthIDPProfile sample_profile -relyingPartyMetadataURL https://rp.customer.com/metadata -refreshInterval 50 -status < > 

Una vez configurado el punto final, un dispositivo NetScaler primero sondea el dispositivo de punto final conocido de la parte que confía para leer la configuración. Actualmente, el dispositivo NetScaler procesa solo el extremo ‘jwks_uri’.

• Si ‘jwks_uri’ está ausente en la respuesta, el estado del perfil no está completo.
• Si el ‘jwks_uri’ está presente en la respuesta, NetScaler sondea ese punto final también para leer las claves públicas de la parte que confía.

Nota:

Solo se admiten los algoritmos de tipo de cifrado RSAES-OAEP y AES256 GCM para el cifrado de tokens.

Compatibilidad con atributos personalizados en OpenID Connect

Es posible que los usuarios de confianza deOpenIDnecesiten más que un nombre de usuario o un nombre principal de usuario (UPN) en el token para crear el perfil de usuario o tomar decisiones de autorización. Por lo general, los grupos de usuarios deben aplicar directivas de autorización para el usuario. A veces, se necesitan más detalles, como el nombre o el apellido, para aprovisionar una cuenta de usuario.

El dispositivo NetScaler configurado como IdP se puede utilizar para enviar atributos adicionales en el OidCID_token mediante expresiones. Las expresiones de directiva avanzadas se utilizan para enviar los atributos personalizados según el requisito. El IdP de Citrix evalúa las expresiones correspondientes a los atributos y, a continuación, calcula el token final.

El dispositivo NetScaler aplican automáticamenteJSONifya los datos de salida. Por ejemplo, los números (como SSN) o los valores booleanos (true o false) no están rodeados de comillas. Los atributos con varios valores, como los grupos, se colocan dentro de un marcador de matriz (“[” y “]”). Los atributos de tipo complejo no se calculan automáticamente y puede configurar la expresión PI de esos valores complejos según su requisito.

Para configurar el punto final de la parte de confianza mediante la CLI

En la línea de comandos, escriba:

set oauthidpprofile  -attributes  

puede describirse como:

Attribute1=PI-Expression@@@attribute2=PI-Expression@@@

‘attribute1’, ‘attribute2’ son cadenas literales que representan el nombre del atributo que se insertará en id_token.

Nota:Puede configurar hasta 2.000 bytes de atributos.

Ejemplo:set oauthidpprofile sample_1 -attributes q{myname=http.req.user.name@@@ssn="123456789"@@@jit="false"@@@groups=http.req.user.groups}

• Laπde direc前es una表达式的值tiva avanzada que representa el valor que se va a utilizar para el atributo. La expresión PI se puede usar para enviar un literal de cadena, como “‘cadena codificada”’. El literal de cadena está rodeado de comillas dobles alrededor de comillas simples o comillas dobles alrededor de un inicio y un patrón (como se indicó anteriormente, el patrón de inicio es “q {“). Si el valor del atributo no es un literal de cadena, la expresión se evalúa en tiempo de ejecución y su valor se envía en token. Si el valor en tiempo de ejecución está vacío, el atributo correspondiente no se agrega al token de ID.
• Como se define en el ejemplo, “false” es una cadena literal para el atributo “jit”. Además, “ssn” tiene un valor codificado como referencia. Los grupos ymyname”” son expresiones PI que producen cadenas.

Compatibilidad con implementaciones de GSLB activo-activas en NetScaler Gateway

NetScalerGateway configurado como proveedor de identidad (IDP) mediante el protocolo OIDC puede admitir implementaciones de GSLB activo-activas. La implementación activa y activa de GSLB en el IDP de NetScaler Gateway proporciona la capacidad de equilibrar la carga de una solicitud de inicio de sesión de usuario entrante en varias ubicaciones geográficas.

Importante

Citrix recomienda vincular certificados de CA al servicio SSL y habilitar la validación de certificados en el servicio SSL para mejorar la seguridad.

Para obtener más información sobre cómo configurar la configuración de GSLB, consulteEjemplo de configuración y configuración de GSLB.