Tutorial: Integración del inicio de sesión único (SSO) de Azure Active Directory con KnowledgeOwl

En este tutorial aprenderá a integrar KnowledgeOwl con Azure Active Directory (Azure AD). Al integrar KnowledgeOwl con Azure AD, puede hacer lo siguiente:

  • Controlar en Azure AD quién tiene acceso a KnowledgeOwl.
  • Permitir que los usuarios inicien sesión automáticamente en KnowledgeOwl con sus cuentas de Azure AD.
  • Administrar las cuentas desde una ubicación central (Azure Portal).

Prerrequisitos

Para empezar, necesita los siguientes elementos:

  • Una suscripción de Azure AD. Si no tiene una suscripción, puede crear una cuenta gratuita.
  • Una suscripción de KnowledgeOwl con el inicio de sesión único habilitado.

Descripción del escenario

En este tutorial, va a configurar y probar el inicio de sesión único de Azure AD en un entorno de prueba.

  • KnowledgeOwl admite el inicio de sesión único iniciado por SP e IDP.
  • KnowledgeOwl admite el aprovisionamiento de usuarios Just-In-Time.

Para configurar la integración de KnowledgeOwl en Azure AD, es preciso agregar KnowledgeOwl desde la galería a la lista de aplicaciones SaaS administradas.

  1. Inicie sesión en Azure Portal con una cuenta personal, profesional o educativa de Microsoft.
  2. En el panel de navegación de la izquierda, seleccione el servicio Azure Active Directory.
  3. Vaya a Aplicaciones empresariales y seleccione Todas las aplicaciones.
  4. Para agregar una nueva aplicación, seleccione Nueva aplicación.
  5. En la sección Agregar desde la galería, escriba KnowledgeOwl en el cuadro de búsqueda.
  6. Seleccione KnowledgeOwl en el panel de resultados y agregue la aplicación. Espere unos segundos mientras la aplicación se agrega al inquilino.

Configuración y prueba del inicio de sesión único de Azure AD para KnowledgeOwl

Configure y pruebe el inicio de sesión único de Azure AD con KnowledgeOwl con un usuario de prueba llamado B.Simon. Para que el inicio de sesión único funcione, es preciso establecer una relación de vínculo entre un usuario de Azure AD y el usuario relacionado de KnowledgeOwl.

Para configurar y probar el inicio de sesión único de Azure AD con KnowledgeOwl, lleve a cabo los siguientes pasos:

  1. Configuración del inicio de sesión único de Azure AD , para permitir que los usuarios puedan utilizar esta característica.
    1. Creación de un usuario de prueba de Azure AD , para probar el inicio de sesión único de Azure AD con B.Simon.
    2. Asignación del usuario de prueba de Azure AD , para habilitar a B.Simon para que use el inicio de sesión único de Azure AD.
  2. Configuración del inicio de sesión único en KnowledgeOwl : para configurar los valores de inicio de sesión único en la aplicación.
    1. Crear un usuario de prueba en KnowledgeOwl : para tener un homólogo de B.Simon en KnowledgeOwl vinculado a la representación del usuario en Azure AD.
  3. Prueba del inicio de sesión único : para comprobar si la configuración funciona.

Configuración del inicio de sesión único de Azure AD

Siga estos pasos para habilitar el inicio de sesión único de Azure AD en Azure Portal.

  1. En Azure Portal, en la página de integración de la aplicación KnowledgeOwl, busque la sección Administrar y seleccione Inicio de sesión único.

  2. En la página Seleccione un método de inicio de sesión único, elija SAML.

  3. En la página Configuración del inicio de sesión único con SAML, haga clic en el icono de lápiz de Configuración básica de SAML para editar la configuración.

    Edit Basic SAML Configuration

  4. En la sección Configuración básica de SAML, si desea configurar la aplicación en modo iniciado por IDP, escriba los valores de los siguientes campos:

    a. En el cuadro de texto Identificador, escriba la dirección URL con uno de los siguientes patrones:

    https://app.knowledgeowl.com/sp
    https://app.knowledgeowl.com/sp/id/<unique ID>
    

    b. En el cuadro de texto Dirección URL de respuesta, escriba la dirección URL con uno de los siguientes patrones:

    https://subdomain.knowledgeowl.com/help/saml-login
    https://subdomain.knowledgeowl.com/docs/saml-login
    https://subdomain.knowledgeowl.com/home/saml-login
    https://privatedomain.com/help/saml-login
    https://privatedomain.com/docs/saml-login
    https://privatedomain.com/home/saml-login
    
  5. Haga clic en Establecer direcciones URL adicionales y siga este paso si desea configurar la aplicación en el modo iniciado por SP:

    En el cuadro de texto URL de inicio de sesión, escriba una dirección URL con uno de los siguientes patrones:

    https://subdomain.knowledgeowl.com/help/saml-login
    https://subdomain.knowledgeowl.com/docs/saml-login
    https://subdomain.knowledgeowl.com/home/saml-login
    https://privatedomain.com/help/saml-login
    https://privatedomain.com/docs/saml-login
    https://privatedomain.com/home/saml-login
    

    Nota:

    Estos valores no son reales. Debe actualizar este valor con la dirección URL de respuesta, el identificador y la dirección URL de inicio de sesión reales, tal como se explica más adelante en el tutorial.

  6. La aplicación KnowledgeOwl espera las aserciones de SAML en un formato específico, que requiere que se agreguen asignaciones de atributos personalizados a la configuración de los atributos del token de SAML. La siguiente captura de muestra la lista de atributos predeterminados.

    image

  7. Además de lo anterior, la aplicación KnowledgeOwl espera que se devuelvan algunos atributos más, que se muestran a continuación, en la respuesta de SAML. Estos atributos también se rellenan previamente, pero puede revisarlos según sus requisitos.

    Nombre Atributo de origen Espacio de nombres
    ssoid user.mail http://schemas.xmlsoap.org/ws/2005/05/identity/claims
  8. En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, busque Certificado (sin procesar) y seleccione Descargar para descargarlo y guardarlo en el equipo.

    The Certificate download link

  9. En la sección Set up KnowledgeOwl (Configurar KnowledgeOwl), copie las direcciones URL que necesite.

    Copy configuration URLs

Creación de un usuario de prueba de Azure AD

En esta sección, va a crear un usuario de prueba llamado B.Simon en Azure Portal.

  1. En el panel izquierdo de Azure Portal, seleccione Azure Active Directory, Usuarios y Todos los usuarios.
  2. Seleccione Nuevo usuario en la parte superior de la pantalla.
  3. En las propiedades del usuario, siga estos pasos:
    1. En el campo Nombre, escriba .
    2. En el campo Nombre de usuario, escriba . Por ejemplo, B.Simon@contoso.com.
    3. Active la casilla Show password (Mostrar contraseña) y, después, anote el valor que se muestra en el cuadro Contraseña.
    4. Haga clic en Crear.

Asignación del usuario de prueba de Azure AD

En esta sección va a permitir que B.Simon acceda a KnowledgeOwl mediante el inicio de sesión único de Azure.

  1. En Azure Portal, seleccione sucesivamente Aplicaciones empresariales y Todas las aplicaciones.
  2. En la lista de aplicaciones, seleccione KnowledgeOwl.
  3. En la página de información general de la aplicación, busque la sección Administrar y seleccione Usuarios y grupos.
  4. Seleccione Agregar usuario. A continuación, en el cuadro de diálogo Agregar asignación, seleccione Usuarios y grupos.
  5. En el cuadro de diálogo Usuarios y grupos, seleccione B.Simon de la lista de usuarios y haga clic en el botón Seleccionar de la parte inferior de la pantalla.
  6. Si espera que se asigne un rol a los usuarios, puede seleccionarlo en la lista desplegable Seleccionar un rol. Si no se ha configurado ningún rol para esta aplicación, verá seleccionado el rol "Acceso predeterminado".
  7. En el cuadro de diálogo Agregar asignación, haga clic en el botón Asignar.

Configuración del inicio de sesión único en KnowledgeOwl

  1. En otra ventana del explorador web, inicie sesión en el sitio de la empresa de KnowledgeOwl como administrador.

  2. Haga clic en Settings (Configuración) y, a continuación, seleccione SSO.

    Screenshot shows SSO selected from the Settings menu.

  3. En la pestaña SAML Settings (Configuración de SAML), realice los pasos siguientes:

    Screenshot shows SAML S S O Integration where you can make the changes described here.

    a. Seleccione Enable SAML SSO (Habilitar SSO de SAML).

    b. Copie el valor SP Entity ID (Id. de identidad de SP) en Identificador (Id. de entidad) en la sección Configuración básica de SAML de Azure Portal.

    c. Copie el valor de SP Login URL (Dirección URL de inicio de sesión SP) y péguelo en el cuadro de texto Sign-on URL and Reply URL (Direcciones URL de inicio de sesión y respuesta) de la sección Configuración básica de SAML de Azure Portal.

    d. En el cuadro de texto IdP entityID (Id. de entidad de IdP), pegue el valor de Identificador de Azure AD que copió de Azure Portal.

    e. En el cuadro de texto IdP Login URL (Dirección URL de inicio de sesión de IdP), pegue el valor de la URL de inicio de sesión que ha copiado de Azure Portal.

    f. En el cuadro de texto IdP Logout URL (Dirección URL de cierre de sesión del IdP), pegue el valor de URL de cierre de sesión que ha copiado de Azure Portal.

    g. Cargue el certificado que descargó de Azure Portal haciendo clic en el vínculo Upload (Cargar) situado debajo de IdP Certificate (Certificado del IdP).

    h. Haga clic en Guardar en la parte inferior de la página.

    Screenshot shows the Save button.

    i. Abra la pestaña SAML Attribute Map (Asignación de atributos de SAML) para asignar atributos y realice los pasos siguientes:

    Screenshot shows Map SAML Attributes where you can make the changes described here.

    • Escriba http://schemas.xmlsoap.org/ws/2005/05/identity/claims/ssoid en el cuadro de texto Id. de SSO.
    • Escriba http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress en el cuadro de texto Nombre de usuario / correo electrónico.
    • Escriba http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname en el cuadro de texto Nombre.
    • Escriba http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname en el cuadro de texto Apellidos.

    j. Haga clic en Guardar en la parte inferior de la página.

    Screenshot shows the Save button1.

Creación de un usuario de prueba de KnowledgeOwl

En esta sección se crea un usuario llamado B.Simon en KnowledgeOwl. KnowledgeOwl admite el aprovisionamiento de usuarios Just-In-Time, que está habilitado de forma predeterminada. No hay ningún elemento de acción para usted en esta sección. Si un usuario deja de existir en KnowledgeOwl, se crea otro después de la autenticación.

Nota:

Si necesita crear manualmente un usuario, póngase en contacto con el equipo de soporte técnico de KnowledgeOwl.

Prueba de SSO

En esta sección, probará la configuración de inicio de sesión único de Azure AD con las siguientes opciones.

Iniciado por SP

  • Haga clic en Probar esta aplicación en Azure Portal. Esto le redirigirá a la dirección URL de inicio de sesión de KnowledgeOwl, donde podrá iniciar el flujo de inicio de sesión.

  • Vaya directamente a la dirección URL de inicio de sesión de KnowledgeOwl e inicie el flujo de inicio de sesión desde allí.

Iniciado por IDP

  • Haga clic en Probar esta aplicación en Azure Portal; debería iniciar sesión automáticamente en la instancia de la aplicación KnowledgeOwl para la que configuró el inicio de sesión único.

También puede usar el portal Aplicaciones de Microsoft para probar la aplicación en cualquier modo. Al hacer clic en el icono de KnowledgeOwl en el portal Aplicaciones, si se ha configurado en modo SP, se le redirigirá a la página de inicio de sesión de la aplicación para comenzar el flujo de inicio de sesión; y si se ha configurado en modo IDP, debería iniciar sesión automáticamente en la instancia de la aplicación KnowledgeOwl para la que ha configurado el inicio de sesión único. Para más información acerca del portal Aplicaciones, consulte Inicio de sesión e inicio de aplicaciones desde el portal Aplicaciones.

Pasos siguientes

Una vez configurado KnowledgeOwl, puede aplicar el control de sesión, que protege la filtración y la infiltración de la información confidencial de la organización en tiempo real. El control de sesión procede del acceso condicional. Aprenda a aplicar el control de sesión con Microsoft Defender for Cloud Apps.