> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dominios personalizados

> Configure URL de marca para su portal de verificación y consola con configuración de dominio personalizado y verificación de DNS.

Los dominios personalizados le permiten servir el portal de verificación y la consola de Truthlocks desde su propio dominio. En lugar de `verify.truthlocks.com`, sus usuarios ven `verify.yourdomain.com`.

> [!NOTE]
>
> Los dominios personalizados están disponibles en todos los planes. Navegue a **Configuración > Dominios**.
> en la consola para empezar.

## Tipos de dominio

Truthlocks admite dos tipos de dominios personalizados:

| Tipo | Propósito | Ejemplo |
| :- | :- | :- |
| **Verificación** | Portal de verificación público donde los destinatarios y auditores verifican las atestaciones | `verify.yourdomain.com` |
| **Console** | Consola administrativa para su equipo | `console.yourdomain.com` |

Puede configurar uno o ambos tipos según sus necesidades.

## Configuración de un dominio personalizado

**1. Abrir configuración de dominio**

Navega a **Configuración > Dominios** en la consola.

**2. Añadir un dominio**

Haga clic en **Añadir dominio**, seleccione el tipo de dominio (Verificación o Console), y
introduzca el nombre de host que desea utilizar (por ejemplo, `verify.yourdomain.com`).

**3. Añadir el registro DNS**

Truthlocks genera un token de verificación único para su dominio. Agregue un registro TXT
registro a su configuración DNS:

| Campo | Valor |
| :- | :- |
| **Tipo** | `TXT` |
| **Nombre** | `_truthlocks-verify` |
| **Valor** | El token de verificación que se muestra en la consola |

Copie el token usando el botón **Copiar** junto a él.

**4. Verificar el dominio**

Después de agregar el registro DNS, haga clic en **Verificar registro DNS** en la consola.
Truthlocks busca el registro TXT y actualiza el estado del dominio.

> [!TIP]
>
> La propagación de DNS puede tardar hasta 48 horas, aunque la mayoría de los proveedores la propagan.
> en cuestión de minutos. Si la verificación falla, espere unos minutos e inténtelo de nuevo.

## Estados de dominio

Cada dominio progresa a través de tres estados:

| Estado | Significado |
| :- | :- |
| **Pendiente** | El dominio ha sido añadido pero el registro DNS aún no ha sido verificado. |
| **Verificado** | El registro DNS TXT fue encontrado y validado. El dominio se activa automáticamente. |
| **Activo** | El dominio está en vivo y sirviendo tráfico para su inquilino. |

## Gestión de dominios a través de la API

Puede agregar, listar y verificar dominios personalizados mediante programación.

### Listar dominios

```http Request theme={null}
GET /v1/settings/domains
X-API-Key: tl_live_...
```

```json Response theme={null}
{
  "domains": [
    {
      "id": "dom_abc123",
      "tenant_id": "tn_xyz789",
      "type": "VERIFY",
      "hostname": "verify.acme.com",
      "status": "ACTIVE",
      "verification_token": "tl-verify-abc123def456",
      "verified_at": "2026-03-25T14:30:00Z",
      "created_at": "2026-03-25T14:00:00Z"
    }
  ]
}
```

### Añadir un dominio

```http Request theme={null}
POST /v1/settings/domains
X-API-Key: tl_live_...
Content-Type: application/json

{
  "type": "VERIFY",
  "hostname": "verify.acme.com"
}
```

El campo `type` acepta `VERIFY` para dominios de verificación o `CONSOLE` para dominios de consola. La respuesta incluye el `verification_token` que necesita para la configuración de DNS.

### Verificar un dominio

```http Request theme={null}
POST /v1/settings/domains/{domain_id}/verify
X-API-Key: tl_live_...
```

Devuelve el objeto de dominio actualizado. Si el registro DNS no se encuentra, el estado permanece `PENDING`.

## Ejemplo: configuración completa

```bash theme={null}
# 1. Add the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type": "VERIFY", "hostname": "verify.acme.com"}'

# 2. Add the TXT record to your DNS (using your DNS provider)
# Name:  _truthlocks-verify
# Value: <verification_token from response>

# 3. Verify the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains/dom_abc123/verify \
  -H "X-API-Key: tl_live_..."
```

## Solución de problemas

### La verificación sigue fallando

1. Confirme que el nombre del registro TXT sea exactamente `_truthlocks-verify` (algunos proveedores añaden el dominio automáticamente; busque duplicados como `_truthlocks-verify.yourdomain.com.yourdomain.com`).
2. Espere la propagación de DNS. Use `dig TXT _truthlocks-verify.yourdomain.com` para confirmar que el registro es visible.
3. Asegúrese de que el valor TXT coincida exactamente con el token que se muestra en la consola, sin espacios adicionales.

### El dominio está verificado pero no activo

Los dominios verificados pasan a Activo automáticamente. Si el estado no se actualiza, actualice la página o vuelva a obtenerlo a través de la API.

## Relacionado

> [card] [Marca personalizada](https://docs.truthlocks.com/guides/enterprise-branding.md)
>
> Suba logotipos y establezca los colores de la marca para las páginas de verificación y los correos electrónicos.

> [card] [Entrega de correo electrónico](https://docs.truthlocks.com/security/email-delivery.md)
>
> Configure remitentes de correo electrónico y servidores SMTP personalizados.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.