Configurar OpenAM

OpenAM es un proveedor de identidad (IDP) compatible con Security Assertion Markup Language (SAML). Es posible configurar OpenAM 10.1.0 y versiones posteriores como su IDP para los inicios de sesión SAML en ArcGIS Online. El proceso de configuración consta de dos pasos principales: registrar su IDP SAML con ArcGIS Online y registrar ArcGIS Online con el IDP SAML.

Nota:

Para asegurarse de que los inicios de sesión SAML estén configurados de forma segura, revise las prácticas recomendadas de seguridad para SAML.

Información requerida

ArcGIS Online requiere recibir cierta información sobre atributos desde el IDP cuando un usuario se conecta con inicios de sesión SAML. El atributo NameID es obligatorio y su IDP debe enviarlo en la respuesta SAML para que la federación con ArcGIS Online funcione. Dado que ArcGIS Online utiliza el valor de NameID para identificar de forma única un usuario nominal, se recomienda utilizar un valor constante que identifique al usuario de forma única. Cuando un usuario de IDP inicia sesión, ArcGIS Online crea un nuevo usuario con el nombre de usuario NameID_<url_key_for_org> en su almacén de usuarios. Los caracteres permitidos para el valor enviado por NameID son alfanuméricos, _ (guion bajo), . (punto) y @ (arroba). Para los demás caracteres del nombre de usuario creado por ArcGIS Online, se agregará un carácter de escape con guion bajo.

ArcGIS Online admite el flujo de entrada de una dirección de correo electrónico, pertenencias a grupos y un nombre y apellidos determinados de un usuario desde el proveedor de identidad SAML. Se recomienda que proporcione la dirección de correo electrónico del IDP SAML para que el usuario pueda recibir notificaciones. Esto es de utilidad si el usuario se convierte posteriormente en administrador. Disponer de una dirección de correo electrónico en la cuenta permite al usuario recibir notificaciones sobre cualquier actividad administrativa y enviar invitaciones a otros usuarios para que se unan a la organización.

Registrar OpenAM como IDP SAML con ArcGIS Online

  1. Compruebe que haya iniciado sesión como administrador de su organización.
  2. En la parte superior del sitio, haga clic en Organización y haga clic en la pestaña Configuración.
  3. Haga clic en Seguridad en el lado izquierdo de la página.
  4. En la sección Inicios de sesión, haga clic en el botón Nuevo inicio de sesión de SAML y seleccione la opción Un proveedor de identidad. En la página Especificar propiedades, introduzca el nombre de su organización (por ejemplo, City of Redlands). Cuando los usuarios acceden al sitio web de la organización, este texto se muestra como parte de la opción de inicio de sesión SAML (por ejemplo, Usar su cuenta de City of Redlands).
    Nota:

    Seleccionar la opción Un proveedor de entidad le permite registrar un IDP SAML para su organización ArcGIS Online. Para autentificar usuarios con inicios de sesión SAML para varios IDP, registre una federación basada enSAML en lugar de un solo IDP.

  5. Elija Automáticamente o Si reciben una invitación de un administrador para especificar cómo pueden unirse los usuarios a la organización. Al seleccionar la primera opción, los usuarios pueden iniciar sesión en la organización con su inicio de sesión SAML sin que intervenga ningún administrador; su cuenta se registra con la organización automáticamente la primera vez que inician sesión. La segunda opción requiere que el administrador invite a los usuarios necesarios a la organización. Cuando el usuario reciba la invitación, puede iniciar sesión en la organización.
  6. Proporcione la información de metadatos del IDP con una de las tres opciones siguientes:
    • URL: elija esta opción si el acceso a la URL de los metadatos de federación de OpenAM es posible a través de ArcGIS Online. La URL suele ser https://<host>:<port>/openam/saml2/jsp/exportmetadata.jsp.
    • Archivo: elija esta opción si ArcGIS Online no puede acceder a la URL. Obtenga los metadatos de la URL anterior, guárdelos como un archivo XML y cargue el archivo.
    • Parámetros especificados aquí: elija esta opción si no se puede acceder a la URL o al archivo de metadatos de federación. Introduzca manualmente los valores y proporcione los parámetros solicitados: URL de inicio de sesión y certificado, con codificación en formato BASE 64. Póngase en contacto con su administrador de OpenAM para obtenerlos.
  7. Configure los ajustes avanzados cuando proceda:
    • Cifrar aserción: habilite esta opción si OpenAM se configurará para cifrar las respuestas de la aserción SAML.
    • Habilitar solicitud firmada: habilite esta opción para que ArcGIS Online firme la solicitud de autenticación SAML enviada a OpenAM.
    • Id. de entidad: actualice este valor para usar un nuevo Id. de entidad para identificar de forma única su organización de ArcGIS Online en OpenAM.
    • Actualizar perfiles en el inicio de sesión: habilite esta opción para sincronizar automáticamente la información de la cuenta (nombre completo y dirección de correo electrónico) almacenada en los perfiles de usuario de ArcGIS Online con la información de cuenta más reciente recibida desde el IDP. Al habilitar esta opción, cuando un usuario inicia sesión con credenciales SAML su organización puede verificar si la información del IDP ha cambiado desde que la cuenta se creó y, si es así, actualizar el perfil de la cuenta de ArcGIS Online del usuario en consecuencia.
    • Habilitar pertenencia a grupos basada en SAML: habilite esta opción para permitir a los miembros de la organización vincular grupos basados en SAML especificados con grupos de ArcGIS Online durante el proceso de creación de grupos.
    Nota:

    Actualmente, las opciones Propagar cierre de sesión a proveedor de identidad y Dirección URL de cierre de sesión no son compatibles.

  8. Haga clic en Guardar.

Registrar ArcGIS Online como proveedor de servicios de confianza en OpenAM

  1. Configure un IDP alojado en OpenAM.
    1. Inicie sesión en la consola de administración de OpenAM. Normalmente está disponible en https://servername:port/<deploy_uri>/console.
    2. En la pestaña Tareas comunes, haga clic en Crear proveedor de identidades alojadas.
    3. Cree un IDP alojado y agréguelo a un Círculo de confianza. Puede agregarlo a un círculo de confianza existente si ya dispone de uno, o puede crear un círculo de confianza.
    4. De forma predeterminada, el IDP alojado funciona con OpenDJ, el almacén de usuarios integrado que se suministra con OpenAM. Si desea conectar OpenAM con cualquier otro almacén de usuarios como Active Directory, debe crear una nueva fuente de datos en la pestaña Control de acceso de la consola de administración principal de OpenAM.
  2. Configure ArcGIS Online como proveedor de servicios de confianza en OpenAM.
    1. Obtén el archivo de metadatos de tu organización de ArcGIS Online y guárdalo como un archivo XML.

      Para obtener el archivo de metadatos, inicie sesión como administrador de su organización y abra la página de la organización. Haga clic en la pestaña Configuración y haga clic en Seguridad en el lado izquierdo de la página. En la sección Inicios de sesión, en Inicio de sesión SAML, haga clic en el botón Descargar metadatos de proveedores de servicios.

    2. En la consola de administración de OpenAM, en Tareas comunes, haga clic en Registrar proveedor de servicios remotos.
    3. Seleccione la opción Archivo para los metadatos y cargue el archivo XML de metadatos guardado en el paso anterior.
    4. Agregue este proveedor de servicios al mismo círculo de confianza al que haya agregado el IDP.
  3. Configure el formato de NameID y los atributos que OpenAM debe enviar a ArcGIS Online después de autenticar al usuario.
    1. En la consola de administración de OpenAM, haga clic en la pestaña Federación. La pestaña contiene el círculo de confianza que ha agregado previamente, y los proveedores de servicios e IDP.
    2. En Proveedores de identidades, haga clic en su IDP.
    3. En la pestaña Contenido de aserción, debajo de Formato de Id. de nombre, compruebe que urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified figura en primer lugar. Este es el formato de NameID que ArcGIS Online solicitará en la solicitud de SAML a OpenAM.
    4. En Mapa de valores de ID de nombres, asigna un atributo del perfil del usuario, como mail o upn, que se devolverá como NameID a ArcGIS Online una vez que se autentique el usuario.

      Ejemplo: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified =upn

    5. Haga clic en la pestaña Procesando aserciones en el IDP. En Asignador de atributos, configure los atributos a partir del perfil de usuario que desee enviar a ArcGIS Online.

      Haga clic en Guardar para guardar el formato NameID y los cambios de contenido de los atributos.

    6. En la pestaña Federación de la consola de administración de OpenAM, busque el proveedor de servicios de ArcGIS Online en Proveedores de entidades.
    7. En la pestaña Contenido de aserción, en Cifrado, seleccione la opción Aserción si ha elegido la configuración avanzada Cifrar aserción al registrar OpenAM como IDP SAML en ArcGIS Online.
    8. En Formato de Id. de nombre, compruebe si urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified figura en primer lugar. Este es el formato de NameID que solicitará ArcGIS Online en su solicitud de SAML a OpenAM.
    9. Haga clic en la pestaña Procesando aserciones en el IDP. En Asignador de atributos, configure los atributos a partir del perfil de usuario que desea enviar a ArcGIS Online.
    10. Haga clic en Guardar para guardar los cambios de formato de Id. de nombre y de contenido de los atributos.
  4. Reinicie el servidor web donde se ha implementado OpenAM.