Resumen
Integrations le permite adjuntar conexiones de proveedor de servicio de inicio de sesión único a una cuenta a través de la pestaña SSO SP. Además de SAML, que utiliza un formulario estructurado, la pestaña admite tipos de proveedor de servicio que no son SAML, como SIP2, PatronSSLAPI, OAuth y Regex. Estos tipos no SAML se configuran a través de un editor de JSON en bruto en lugar de campos de entrada individuales, y este artículo explica para qué sirve cada tipo y cómo trabajar con ellos.
Introducción
La pestaña SSO SP gestiona las conexiones de proveedor de servicio que permiten que un sistema externo autentique a los usuarios para iniciar sesión en KnowledgeCity. Cada conexión tiene un tipo. Cuando elige SAML, Integrations muestra un formulario estructurado con campos dedicados. Cuando elige un tipo que no es SAML, Integrations muestra un panel plegable que envuelve un editor JSON, porque esos tipos aún no tienen un formulario fijo.
Este flujo de trabajo lo utilizan los administradores que gestionan la autenticación a nivel de cuenta, incluidas las conexiones a sistemas de bibliotecas y de usuarios (patrons). Les brinda una forma flexible de definir una conexión editando directamente su configuración de conexión, lo cual es útil cuando un proveedor necesita opciones de configuración que un formulario fijo no expondría.
Conceptos clave
- SSO service provider connection (conexión de proveedor de servicio SSO): un sistema externo que autentica a sus usuarios para que puedan iniciar sesión en KnowledgeCity. Integrations almacena una o más de estas conexiones por cuenta.
- SP type (tipo de SP): la categoría de una conexión. SAML utiliza un formulario estructurado, mientras que los tipos que no son SAML se configuran a través de un editor JSON.
- SIP2: un tipo no SAML utilizado para la autenticación de usuarios de bibliotecas (patrons). Como tipo no SAML, su configuración de conexión se introduce como JSON.
- PatronSSLAPI: un tipo no SAML utilizado para la autenticación de usuarios a través de una API de proveedor. Se configura a través del editor JSON en lugar de un formulario fijo.
- OAuth: un tipo no SAML basado en tokens que aún no tiene un formulario estructurado, por lo que su configuración de conexión se define como JSON.
- Regex: un tipo no SAML que coincide según un patrón. Al igual que los otros tipos no SAML, su configuración se introduce como JSON.
- JSON panel (panel JSON): un panel plegable que envuelve el editor de una única conexión no SAML. Su encabezado muestra el tipo y el nombre de la conexión, y puede expandirlo o contraerlo para editar la configuración.
- Connection settings (configuración de conexión): la estructura JSON que contiene toda la configuración de una conexión. Los campos disponibles en el editor son lo que esta estructura contenga, y el nombre de la conexión se toma del nombre de la organización de la conexión, o de su etiqueta de visualización cuando no se establece un nombre de organización.
Pasos a seguir
Abrir la pestaña SSO SP
Vaya a la pantalla de edición de la cuenta y abra la pestaña SSO SP. Esta pestaña enumera las conexiones de proveedor de servicio configuradas para la cuenta y es donde las agrega y edita.
Elegir el tipo de proveedor de servicio
Seleccione el tipo de conexión para el proveedor que está conectando. Si elige SAML, Integrations presenta un formulario estructurado con campos individuales. Si elige un tipo que no es SAML, como SIP2, PatronSSLAPI, OAuth, o Regex, Integrations presenta en su lugar un panel JSON para esa conexión.
Decidir qué tipo usar
Haga coincidir el tipo con el sistema externo. Use SAML cuando el proveedor admita la federación SAML y quiera un formulario guiado. Use OAuth para la autenticación basada en tokens. Use SIP2 o PatronSSLAPI cuando se conecte a un sistema de biblioteca o de autenticación de usuarios que hable esos protocolos. Use Regex cuando el acceso se determine mediante la coincidencia de un patrón. Para cada elección que no sea SAML, la configuración se introduce como JSON.
Editar la configuración de conexión como JSON
Para un tipo que no es SAML, expanda el panel JSON y use el área de texto del editor para introducir o editar la configuración de conexión. Debido a que estos tipos no utilizan un formulario estructurado, cada valor de configuración se define aquí como un campo dentro del JSON. Introduzca JSON válido para que el editor acepte su entrada. El encabezado del panel refleja el tipo de conexión y su nombre, donde el nombre proviene del nombre de la organización de la conexión o de su etiqueta de visualización.
Resolver cualquier error de validación
El editor comprueba su JSON mientras trabaja. Si el contenido no es JSON válido, aparece un mensaje de error debajo del área de texto. Corrija el problema informado, por ejemplo una coma faltante o una llave sin cerrar, hasta que el error desaparezca.
Guardar o eliminar la conexión
Cuando su configuración sea válida, use la acción Update en el panel para guardar la conexión. Para eliminar una conexión que ya no necesite, use la acción Delete en el mismo panel.
Conclusión
Integrations admite varios tipos de proveedor de servicio en la pestaña SSO SP. SAML utiliza un formulario estructurado, mientras que los tipos que no son SAML —SIP2, PatronSSLAPI, OAuth y Regex— se configuran editando la configuración de conexión como JSON en bruto en un panel plegable. Elija el tipo que coincida con el sistema externo, mantenga el JSON válido, y actualice la conexión para que los administradores mantengan el control total sobre los proveedores que aún no tienen un formulario fijo.