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

# Restricción del acceso a un tenant mediante una lista blanca de direcciones IP

> Restrinja el acceso a un tenant con la función lista blanca de IP en el ABBYY FlexiCapture 12 Authentication Module, habilitada en la consola o en la tabla dbo.Tenant.

<Info>
  Esta sección solo está disponible para usuarios con permisos de administrador en ABBYY FlexiCapture.
</Info>

Para mejorar la seguridad de su tenant, puede usar una lista blanca de direcciones IP.

La función **lista blanca de IP** del ABBYY FlexiCapture 12 Authentication Module puede configurarse para restringir el acceso al tenant desde direcciones IP que no figuren en una lista blanca predefinida. Esta función no está habilitada de forma predeterminada. Para obtener más información, consulte [Habilitar la función lista blanca de IP](#activation).

<div id="requirements-and-supported-ip-address-formats">
  ## Requisitos y formatos de direcciones IP compatibles
</div>

Tenga en cuenta los siguientes requisitos:

* No se puede usar una lista de direcciones IP predeterminadas del tenant como lista blanca.
* Se requiere ABBYY FlexiCapture Authentication Module.

De forma predeterminada, solo se admite el protocolo IPv4 en los siguientes formatos:

| Formato                                                    | Ejemplo           |
| ---------------------------------------------------------- | ----------------- |
| Una dirección IP específica                                | `192.168.0.48`    |
| Un rango de direcciones IP en formato CIDR                 | `192.168.0.48/24` |
| Acceso desde un equipo local que ejecuta Processing Server | `::1`             |

Si el equipo que ejecuta Processing Server tiene habilitados los protocolos IPv4 e IPv6 al mismo tiempo, también debe [especificar la dirección del nodo IPv6 en la lista blanca](#ipv6).

## <a id="activation" />Habilitar la función de lista blanca de IP

Puede habilitar la lista blanca de IP tanto en la tabla **dbo.Tenant** como en la Consola de administración y supervisión.

<div id="enable-the-ip-whitelist-in-the-dbotenant-table">
  ### Habilite la lista blanca de IP en la tabla dbo.Tenant
</div>

Para habilitar la función de lista blanca de IP, establezca el cuarto bit del tenant correspondiente en el campo **Flags** de la tabla **dbo.Tenant**.

Las siguientes instrucciones toman Microsoft SQL Server como ejemplo.

<Steps>
  <Step title="Abra SQL Server Management Studio">
    Abra Microsoft SQL Server Management Studio.
  </Step>

  <Step title="Habilite la lista blanca de IP">
    Realice una de las siguientes acciones:

    * Ejecute el siguiente comando:

      ```sql theme={null}
      UPDATE Tenant SET Flags = Flags | 8 WHERE Name = MyTenant
      ```

    * En el campo **Flags** de la tabla **dbo.Tenant**, establezca el cuarto bit para el tenant requerido.
  </Step>

  <Step title="Rellene la lista blanca de IP">
    Rellene la lista blanca de IP en la tabla **dbo.TenantWhiteIp**:

    * En la columna **TenantId**, especifique el ID del tenant.
    * En la columna **IP**, especifique la dirección IP o el rango de IP incluidos en la lista blanca para ese tenant.

    <Note>
      Puede encontrar el ID de un tenant en la tabla **dbo.Tenant**.
    </Note>
  </Step>
</Steps>

<div id="enable-the-ip-whitelist-in-the-administration-and-monitoring-console">
  ### Habilitar la lista blanca de IP en la Consola de administración y supervisión
</div>

<Steps>
  <Step title="Inicie la consola">
    Inicie la Consola de administración y supervisión en el tenant correspondiente.
  </Step>

  <Step title="Abra la configuración de la lista blanca de IP">
    Vaya a **Settings** > **IP Whitelist**.
  </Step>

  <Step title="Habilite la lista blanca de IP">
    Seleccione **Enable IP whitelisting**.
  </Step>

  <Step title="Especifique las direcciones IP permitidas">
    En el campo **Allowed IP address blocks**, especifique las direcciones IP permitidas o el rango de direcciones en formato CIDR.

    <Note>
      Cuando especifica direcciones IP en formato CIDR, el programa calcula automáticamente el rango de direcciones IP.
    </Note>
  </Step>

  <Step title="Guarde la configuración">
    Haga clic en **Save**.
  </Step>
</Steps>

<Info>
  Con la Consola de administración y supervisión, solo puede incluir direcciones IP en la lista blanca dentro de los tenants, no en el entorno principal. Debe tener el rol de ABBYY FlexiCapture administrator o Administrador del tenant para incluir direcciones IP en la lista blanca.
</Info>

## <a id="ipv6" />Protocolo IPv6

Si el equipo que ejecuta Processing Server tiene habilitados los protocolos IPv4 e IPv6, debe especificar también la dirección de la máquina que tiene IPv6 habilitado. Como alternativa, puede deshabilitar el protocolo IPv6.

Para las conexiones proxy, especifique la dirección IPv6 del servidor proxy en la lista blanca de IP.

La siguiente captura de pantalla muestra un ejemplo de lista blanca de IPv6:

<Frame>
  <img src="https://mintcdn.com/abbyy/8aWHPAJyzWmTqglX/images/flexi-capture/ipv6.png?fit=max&auto=format&n=8aWHPAJyzWmTqglX&q=85&s=23f53f7d0233abdb16651cbbeaaea8ff" alt="Captura de pantalla de la tabla dbo.TenantWhiteIp que muestra un ejemplo de entrada de lista blanca de IPv6, con la dirección IPv6 resaltada en la columna IP de un tenant." width="439" height="104" data-path="images/flexi-capture/ipv6.png" />
</Frame>

<div id="get-the-ip-whitelist-using-the-abbyy-flexicapture-api">
  ## Obtención de la lista blanca de IP con la API de ABBYY FlexiCapture
</div>

Para obtener la lista blanca de IP, use el método [GetWhiteIPList](/es/flexi-capture/get-white-ip-list):

```text theme={null}
GetWhiteIPList("ID_Tenant" or "-1")
```

Entre paréntesis, especifique el ID de un tenant concreto o `-1` para mostrar las direcciones incluidas en la lista blanca para todos los tenants.

El siguiente script de PowerShell muestra un ejemplo de llamada de API:

```powershell theme={null}
$url = "http://localhost"
$authUri = $url + '/FlexiCapture12/Server/AuthAPI/v1/WSDL'
$authSvc = New-WebServiceProxy -Uri $authUri -UseDefaultCredential
$test = $authSvc.GetWhiteIPList(-1)
$test
```

Al ejecutarse, este script muestra las direcciones IP incluidas en la lista blanca.
