# SolarWinds

> Integrar Ironchip en SolarWinds mediante SAML: crear la aplicación, configurar el proveedor de identidad en SolarWinds y crear el usuario SAML.

URL: https://docs.ironchip.com/identidad/integraciones/saas/solarwinds/

Ironchip actúa como proveedor de identidad SAML de SolarWinds. Esta guía explica cómo configurar el proveedor de identidad en SolarWinds y crear los usuarios que se autenticarán con Ironchip.

## Requisitos

- Acceso a la consola de administración de Ironchip.
- Un usuario con permisos para realizar la configuración en SolarWinds.

## Configuración en Ironchip

1. En la consola de Ironchip, crea una aplicación de tipo **SAML**.
2. Descarga el archivo de metadatos.

   [Imagen: Creación de la aplicación SAML en la consola de Ironchip]

   [Imagen: Descarga del archivo de metadatos de Ironchip]

## Configuración en SolarWinds

### Añadir el proveedor de identidad

1. Ve a **Settings** y después a **All Settings**.

   [Imagen: Menú Settings de SolarWinds]

2. En **USER ACCOUNTS**, haz clic en **SAML Configuration**.

   [Imagen: Sección SAML Configuration dentro de USER ACCOUNTS]

3. Añade un nuevo proveedor de identidad (Identity Provider).

   [Imagen: Botón para añadir un nuevo Identity Provider]

4. En la primera página, comprueba que la URL es correcta y haz clic en **Next**.

   [Imagen: Primera página del asistente con la URL de SolarWinds]

5. En la página siguiente aparecen dos valores: el **Audience URI** y el **SSO Service URL**. Anótalos.

   [Imagen: Página con el Audience URI y el SSO Service URL de SolarWinds]

### Generar la URL de metadatos para Ironchip

Ironchip pide la URL de los metadatos del proveedor de servicios. Para obtenerla, toma este código como referencia y sustituye los valores:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" validUntil="2122-09-16T10:40:54Z" cacheDuration="PT604800S" entityID="<AUDIENCE_URI>">
  <md:SPSSODescriptor AuthnRequestsSigned="false" WantAssertionsSigned="false" protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
    <md:NameIDFormat>urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress</md:NameIDFormat>
    <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="<SSO_SERVICE_URL>" index="1"/>
  </md:SPSSODescriptor>
</md:EntityDescriptor>
```

- Sustituye el contenido de `entityID` por el **Audience URI**.
- Sustituye el contenido de `Location` por el **SSO Service URL**.

Cuando tengas el bloque con los datos cambiados, súbelo a una dirección pública de internet y escribe su URL, en formato raw, en el campo **Metadata URL** de la aplicación de Ironchip.

[Imagen: Campo Metadata URL en Ironchip]

### Completar los datos del proveedor de identidad

Configura los campos con estos datos:

[Imagen: Formulario del proveedor de identidad en SolarWinds]

- **Identity Provider Name**: el nombre que quieras para el nuevo método de autenticación.
- **SSO Target URL**: la propiedad `Location` de la etiqueta XML `SingleSignOnService` del archivo de metadatos que descargaste de Ironchip.

  [Imagen: URL de SingleSignOnService dentro del archivo de metadatos de Ironchip]

- **Issuer URI**: la propiedad `entityID` de la etiqueta XML `EntityDescriptor` del mismo archivo de metadatos.

  [Imagen: entityID dentro del archivo de metadatos de Ironchip]

- **X.509 Signing Certificate**: copia el certificado del archivo de metadatos de Ironchip y conviértelo al formato de certificado X.509. Puedes usar [esta web](https://www.samltool.com/format_x509cert.php).

  [Imagen: Certificado dentro del archivo de metadatos de Ironchip]

## Crear el usuario SAML

Crea un usuario de tipo SAML en SolarWinds y usa el mismo nombre en el acceso de Ironchip.

1. En **All Settings**, ve a **User Accounts** y entra en **Manage Accounts**.

   [Imagen: Sección Manage Accounts dentro de User Accounts]

2. Al crear la cuenta, selecciona una de las dos opciones de tipo SAML y configura la cuenta o el grupo según tus necesidades.

   [Imagen: Creación de la cuenta de tipo SAML]

3. Usa el mismo nombre de usuario en el acceso de Ironchip.

## Comprobación

Este vídeo (en inglés) muestra una prueba de funcionamiento de la integración:

Vídeo: [Prueba de la integración de SolarWinds con Ironchip](https://play.hubspotvideo.com/v/7745202/id/159484246435)
