# AD Connect

> Instala y configura Ironchip AD Connect en Windows para sincronizar los usuarios y grupos de Active Directory con la consola de administración.

URL: https://docs.ironchip.com/identidad/administracion/sincronizacion/ad-connect/

Ironchip AD Connect es una herramienta que sincroniza los usuarios y grupos de tu Active Directory con la consola de administración de Ironchip. Se instala como servicio de Windows y se configura desde un panel local.

## Instalación

1. Descarga Ironchip AD Connect desde la sección **Plugins** de la consola de administración.
2. Abre una terminal de PowerShell como administrador y ve a la carpeta donde está el ejecutable.
3. Instala el servicio y arráncalo:

   ```powershell
   .\ironchip-ad-connect.exe s install
   .\ironchip-ad-connect.exe s start
   ```

   [Imagen: Comandos de instalación e inicio del servicio en PowerShell]

4. Abre en un navegador `http://localhost:10300`. Es una dirección local donde se aloja el panel de sincronización de usuarios.

   [Imagen: Dirección localhost:10300 en la barra del navegador]

Para parar o desinstalar el servicio, ejecuta:

```powershell
.\ironchip-ad-connect.exe s stop
.\ironchip-ad-connect.exe s uninstall
```

Para ver el resto de comandos disponibles, ejecuta:

```powershell
.\ironchip-ad-connect.exe h
```

## Configuración

El primer paso es establecer la conexión entre Ironchip y Active Directory. En el panel, rellena el apartado de configuración y haz clic en el botón verde **Configure**:

- **User**: dominio y nombre de un usuario de Active Directory con permisos de administrador.
- **Password**: contraseña de ese usuario.
- **SCIM synchronization key**: la clave de sincronización SCIM de tu compañía, que se obtiene en la consola de Ironchip (consulta la sección siguiente).

[Imagen: Formulario Configure de AD Connect con el usuario, la contraseña y la clave de sincronización SCIM]

### Obtener la clave de sincronización SCIM

La **SCIM synchronization key** es el secreto de una credencial SCIM de tu compañía. Para crearla, ve a **Directory > Synchronization > SCIM**, abre la pestaña **Credentials** y haz clic en **Add credential**. Los pasos, con capturas, están en [SCIM en la consola](https://docs.ironchip.com/identidad/administracion/sincronizacion/#scim-en-la-consola).

## Selección de usuarios y grupos

Una vez configurado, elige qué usuarios y grupos sincronizar.

1. En el apartado **Groups**, haz clic en el botón verde **+**.

   [Imagen: Botón + de la pestaña Groups de AD Connect]

2. En la nueva pestaña, selecciona las unidades o grupos que quieres sincronizar con la consola de Ironchip y haz clic en **Add Groups**.

   [Imagen: Árbol de grupos del directorio con el botón Add Groups]

3. Haz clic en **Start** para empezar la sincronización.

   [Imagen: Lista Synchronized Groups y botón Start para iniciar la sincronización]
