# Implementación de SAML de JumpCloud Este artículo contiene ayuda **específica de JumpCloud** para configurar el inicio de sesión con SSO a través de SAML 2.0. Para obtener ayuda para configurar el inicio de sesión con SSO para otro IdP, consulte [Configuración de SAML 2.0](https://bitwarden.com/es-la/help/configure-sso-saml/). La configuración implica trabajar simultáneamente dentro de la aplicación web de Bitwarden y el Portal de JumpCloud. A medida que avanza, recomendamos tener ambos fácilmente disponibles y completar los pasos en el orden en que están documentados. > [!NOTE] > **¿Ya eres un experto en SSO?** Omite las instrucciones en este artículo y descarga capturas de pantalla de configuraciones de muestra para comparar con las tuyas. > > ⬇️ tipo: activo-hipervínculo id: 2jY7iejfs0KgdWBnwhGMHF ## Abre SSO en la aplicación web Inicia sesión en la aplicación web de Bitwarden y abre la Consola de Administrador utilizando el cambiador de producto ([filter]): ![Selector de productos](https://bitwarden.com/assets/2uxBDdQa6lu0IgIEfcwMPP/e3de3361749b6496155e25edcfdcf08b/2024-12-02_11-19-56.png) Abra los **Ajustes** de su **Inicio de sesión único** en la organización: ![Configuración de SAML 2.0 ](https://bitwarden.com/assets/20720mRAluo6crSdTiYJrn/1175889d7f6ab42fe7614f34cdd1dcdd/2024-12-04_09-41-15.png) Si aún no lo has hecho, crea un **identificador SSO**único para tu organización y selecciona **SAML**del menú desplegable de **Tipo**. Mantén esta pantalla abierta para una fácil referencia. Puedes desactivar la opción **Establecer una ID de entidad SP única** en esta etapa si lo deseas. Hacerlo eliminará su ID de organización de su valor de ID de entidad SP, sin embargo, en casi todos los casos, se recomienda dejar esta opción activa. > [!TIP] Self-hosting, use alternative Member Decryption Options. > Hay opciones alternativas de **descifrado de miembro**. Aprenda cómo comenzar a usar [SSO con dispositivos de confianza](https://bitwarden.com/es-la/help/about-trusted-devices/) o [Conector de clave](https://bitwarden.com/es-la/help/about-key-connector/). ## Crea una aplicación SAML de JumpCloud En el Portal de JumpCloud, selecciona **Aplicaciones** del menú y selecciona el botón **Comenzar**: ![Crear aplicación Bitwarden Jumpcloud](https://bitwarden.com/assets/63S5F953fjQN6V4xYKZR3h/d2f5eff68f3c5f4fb7f7b25c71c6dc7d/Create-Bitwarden-App.png) Ingrese `Bitwarden` en el cuadro de búsqueda y seleccione el botón de **configurar**: ![Configura Bitwarden ](https://bitwarden.com/assets/2pFRcBTjlIjBhMbqlKMhxb/fc85babc5dfa8b90b6edf028bb347a52/Configure_Bitwarden.png) > [!NOTE] Custom SAML App > Si te sientes más cómodo con SAML, o quieres tener más control sobre cosas como el Formato de NameID y los Algoritmos de Firma, crea una **Aplicación SAML Personalizada** en su lugar. ### Información general En la sección de **Información General**, configure la siguiente información: | **Campo** | **Descripción** | |------|------| | Etiqueta de visualización | Dale a la aplicación un nombre específico de Bitwarden. | ### Configuración de inicio de sesión único En la sección de **Configuración de Inicio de Sesión Único**, configure la siguiente información: ![Configuración de SSO Jumpcloud ](https://bitwarden.com/assets/29XSIA5254JE0flwlFEGBf/4889cdd2562033c7975deee1b90cd90c/JumpCloud_SSO_Configuration.png) | **Campo** | **Descripción** | |------|------| | IdP Entity ID | Establezca este campo en un valor único, específico de Bitwarden, por ejemplo, `bitwardensso_suempresa`. | | ID de entidad SP | Establezca este campo en el **ID de Entidad SP** pre-generado. Este valor generado automáticamente se puede copiar desde la pantalla de **Ajustes** → **Inicio de sesión único** de la organización y variará según su configuración. | | URL de ACS | Establezca este campo en la **URL del Servicio de Consumo de Aserciones (ACS)** pre-generada. Este valor generado automáticamente se puede copiar desde la pantalla de **Ajustes** → **Inicio de sesión único** de la organización y variará según su configuración. | #### Aplicación SAML personalizada solamente Si creaste una Aplicación SAML personalizada, también necesitarás configurar los siguientes campos de **Configuración de inicio de sesión único**: | **Campo** | **Descripción** | |------|------| | NombreID de SAMLSubject | Especifique el atributo JumpCloud que se enviará en las respuestas SAML como el NameID. | | Formato de NombreID de SAMLSubject | Especifique el formato del NameID enviado en las respuestas SAML. | | Algoritmo de Firma | Seleccione el algoritmo que se utilizará para firmar afirmaciones o respuestas de SAML. | | Afirmación de la señal | Por defecto, JumpCloud firmará la respuesta SAML. Marca esta casilla para firmar la afirmación SAML. | | URL de inicio de sesión | Especifique la URL desde la cual sus usuarios iniciarán sesión en Bitwarden a través de SSO. Para los clientes alojados en la nube, esto es `https://vault.bitwarden.com/#/sso` o `https://vault.bitwarden.eu/#/sso`. Para instancias autoalojadas, esto está determinado por su [URL de servidor configurada](https://bitwarden.com/es-la/help/install-on-premise/#configure-your-domain/), por ejemplo `https://your.domain.com/#/sso`. | ### Atributos En la sección de **Configuración de Inicio de Sesión Único** → **Atributos**, construye las siguientes asignaciones de atributos de SP → IdP. Si seleccionaste la aplicación Bitwarden en JumpCloud, estos ya deberían estar construidos: ![Attribute Mapping ](https://bitwarden.com/assets/5vRaXPal1HJsXhJZX8MdTL/b7c71fb6d4156d104f0f2b826f78a247/jc-attr.png) Una vez que hayas terminado, selecciona el botón de **activar**. ### Descarga el certificado Una vez que la aplicación esté activada, use la opción de menú **SSO** nuevamente para abrir la aplicación Bitwarden creada. Seleccione el menú desplegable de **Certificado IDP** y **Descargue el certificado**: ![Descargar Certificado ](https://bitwarden.com/assets/6Y2DUGlm3LxBK6Ws44SjRg/d15ec22031306fa8d49b9c22d6e7fb5b/download_certificate.png) ### Vincular grupos de usuarios En el Portal de JumpCloud, selecciona **Grupos de Usuarios** del menú: ![Grupos de Usuarios ](https://bitwarden.com/assets/3nIOyl4xedMgTRTNobFqwG/dc5ec9a5d8144249c81a0c4188ede96a/User_Groups.png) Crea un grupo de usuarios específico de Bitwarden, o abre el grupo de usuarios predeterminado de Todos los Usuarios. En cualquier caso, selecciona la pestaña **Aplicaciones** y habilita el acceso a la aplicación SSO de Bitwarden creada para ese grupo de usuarios: ![Bind App Access ](https://bitwarden.com/assets/7BUUQUi79zmEy8xm64qwog/7d5537c45423a87f92485e7b6cad5d5e/jc-group-app.png) > [!NOTE] > Alternativamente, puedes vincular el acceso a grupos de usuarios directamente desde la pantalla **SSO** → **Aplicación Bitwarden**. ## De vuelta a la aplicación web En este punto, has configurado todo lo que necesitas dentro del contexto del Portal JumpCloud. Regresa a la caja fuerte web de Bitwarden para completar la configuración. La pantalla de inicio de sesión único separa la configuración en dos secciones: - **La configuración del proveedor de servicios SAML** determinará el formato de las solicitudes SAML. - **La configuración del proveedor de identidad SAML** determinará el formato que se esperará de las respuestas SAML. ### Configuración del proveedor de servicios Configure los siguientes campos de acuerdo a las opciones seleccionadas en el Portal de JumpCloud [durante la creación de la aplicación](https://bitwarden.com/es-la/help/saml-jumpcloud/#create-a-jumpcloud-saml-app/): | **Campo** | **Descripción** | |------|------| | Formato de Identificación de Nombre | Si creaste una Aplicación SAML personalizada, configura esto a lo que sea el formato especificado de NombreID SAMLSubject en los ajustes. De lo contrario, deja **No especificado**. | | Algoritmo de Firma de Salida | El algoritmo que Bitwarden utilizará para firmar solicitudes SAML. | | Comportamiento de Firma | Si/cuando las solicitudes SAML serán firmadas. Por defecto, JumpCloud no requerirá que las solicitudes estén firmadas. | | Algoritmo Mínimo de Firma Entrante | Si creaste una Aplicación SAML personalizada, configura esto en cualquier Algoritmo de Firma que hayas seleccionado. De lo contrario, déjelo como `rsa-sha256`. | | Quiero Afirmaciones Firmadas | Si creaste una Aplicación SAML personalizada, marca esta casilla si configuraste la opción **Firmar Afirmación** en JumpCloud. De lo contrario, deja sin marcar. | | Validar Certificados | Marque esta casilla cuando utilice certificados confiables y válidos de su IdP a través de una CA de confianza. Los certificados autofirmados pueden fallar a menos que se configuren cadenas de confianza adecuadas dentro de la imagen de docker de inicio de sesión de Bitwarden con SSO. | Cuando termines con la configuración del proveedor de servicios, **Guarda** tu trabajo. ### Configuración del proveedor de Identidad La configuración del proveedor de Identidad a menudo requerirá que vuelvas al Portal de JumpCloud para recuperar los valores de la aplicación: | **Campo** | **Descripción** | |------|------| | ID de la entidad | Ingrese su **IdP Entity ID** de JumpCloud, que se puede obtener de la pantalla de [Configuración de Single Sign-On](https://bitwarden.com/es-la/help/saml-jumpcloud/#single-sign-on-configuration/) de JumpCloud. Este campo distingue entre mayúsculas y minúsculas. | | Tipo de Encuadernación | Establecer para **Redirigir**. | | URL del Servicio de Inicio de Sesión Único | Ingrese su **URL de IdP de JumpCloud**, que se puede obtener de la [pantalla de configuración de inicio de sesión único](https://bitwarden.com/es-la/help/saml-jumpcloud/##single-sign-on-configuration/) de JumpCloud. | | URL del Servicio de Cierre de Sesión Único | Inicie sesión con SSO actualmente **no**admite SLO. Esta opción está planeada para un desarrollo futuro. | | Certificado Público X509 | Pega el [certificado recuperado](https://bitwarden.com/es-la/help/saml-jumpcloud/##download-the-certificate/), eliminando `-----INICIO CERTIFICADO-----` y `-----FIN DEL CERTIFICADO-----` El valor del certificado es sensible a mayúsculas y minúsculas, espacios extra, retornos de carro y otros caracteres extraneous **harán que la validación del certificado falle**. | | Algoritmo de Firma de Salida | Si creaste una Aplicación SAML personalizada, configura esto en cualquier Algoritmo de Firma que hayas seleccionado. De lo contrario, déjelo como `rsa-sha256`. | | Deshabilitar Solicitudes de Cierre de Sesión Salientes | El inicio de sesión con SSO actualmente **no**admite SLO. Esta opción está planeada para un desarrollo futuro. | | Quiere Solicitudes de Autenticación Firmadas | Si JumpCloud espera que las solicitudes SAML estén firmadas. | > [!NOTE] X509 cert expiration > Al completar el certificado X509, toma nota de la fecha de vencimiento. Los certificados tendrán que ser renovados para prevenir cualquier interrupción en el servicio a los usuarios finales de SSO. Si un certificado ha caducado, las cuentas de Administrador y Propietario siempre podrán iniciar sesión con la dirección de correo electrónico y la contraseña maestra. Cuando termines con la configuración del proveedor de identidad, **Guarda** tu trabajo. > [!TIP] Policies for SSO Guides > Puede requerir que los usuarios inicien sesión con SSO activando la política de autenticación de inicio de sesión único. Por favor, tome nota, esto también requerirá la activación de la política de organización única. [Más información](https://bitwarden.com/es-la/help/policies/). ## Prueba la configuración Una vez que tu configuración esté completa, pruébala navegando a [https://vault.bitwarden.com](https://vault.bitwarden.com), ingresando tu dirección de correo electrónico, seleccionando **Continuar**, y seleccionando el botón **Empresa Único-Inicio**: ![Inicio de sesión único empresarial y contraseña maestra ](https://bitwarden.com/assets/3BdlHeogd42LEoG06qROyQ/c68021df4bf45d72e9d37b1fbf5a6040/login.png) Ingrese el [identificador de organización configurado](https://bitwarden.com/es-la/help/saml-jumpcloud/#/) y seleccione **Iniciar sesión**. Si su implementación está configurada con éxito, será redirigido a la pantalla de inicio de sesión de JumpCloud: ![Inicio de sesión de JumpCloud ](https://bitwarden.com/assets/678vDfFuKfH8FBZkhJdt5J/3d21f8344708eea792da7eb3160a9246/JumpCloud_Login.png) ¡Después de autenticarte con tus credenciales de JumpCloud, ingresa tu contraseña maestra de Bitwarden para descifrar tu caja fuerte! > [!NOTE] SSO must be initiated from Bitwarden > Bitwarden no admite respuestas no solicitadas, por lo que iniciar el inicio de sesión desde su IdP resultará en un error. El flujo de inicio de sesión de SSO debe iniciarse desde Bitwarden.