> ## 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.

# Crear, configurar y eliminar un cliente de API pública

> Cree, configure y elimine clientes de API pública en la interfaz de usuario de ABBYY Vantage: gestione secretos de cliente, URI de redirección, flujos de OAuth 2.0 y tiempos de vida de los tokens.

Use la interfaz de usuario de Vantage para crear, configurar y eliminar clientes de API pública que usan las aplicaciones integradas para autenticarse en la Vantage API.

<Note>
  Solo un **Administrador del tenant** puede crear o administrar clientes de API pública.
</Note>

<div id="creating-a-public-api-client">
  ## Creación de un cliente de API pública
</div>

<Steps>
  <Step title="Abrir Configuration">
    En Vantage, haga clic en **Configuration** en el panel izquierdo.
  </Step>

  <Step title="Iniciar la creación del cliente">
    En el cuadro de diálogo **Tenant Administration**, haga una de las siguientes acciones:

    * **Primer cliente de este tenant:** haga clic en **Create API Client**.
    * **Cualquier cliente posterior:** haga clic en **cliente de API pública** y, en la página **cliente de API pública**, abra la lista desplegable **New Client** y haga clic en **Add Client**.

    <Frame>
      <img src="https://mintcdn.com/abbyy/vsKEkGDuRLNqo_T3/images/vantage/tenant-admin/admin_managingrestapiclients_createclient4.png?fit=max&auto=format&n=vsKEkGDuRLNqo_T3&q=85&s=ecbe747d40ede12bf8e00425d21c47f6" alt="Lista desplegable New Client con la opción Add Client" style={{ width: "55%" }} width="704" height="141" data-path="images/vantage/tenant-admin/admin_managingrestapiclients_createclient4.png" />
    </Frame>
  </Step>

  <Step title="Copiar el Client ID y el Client Secret">
    En el cuadro de diálogo **Client Created**, copie cada valor haciendo clic en su icono de **copy**. Como alternativa, haga clic en **Save to File** para descargar un archivo TXT con ambos valores.

    <Frame>
      <img src="https://mintcdn.com/abbyy/vsKEkGDuRLNqo_T3/images/vantage/tenant-admin/admin_managingrestapiclients_createclient2.png?fit=max&auto=format&n=vsKEkGDuRLNqo_T3&q=85&s=9fefc52fdf897922ccef1ca0d53b04ee" alt="Cuadro de diálogo Client Created con Client ID y Client Secret" style={{ width: "55%" }} width="898" height="439" data-path="images/vantage/tenant-admin/admin_managingrestapiclients_createclient2.png" />
    </Frame>

    <Warning>
      El **Client Secret** se muestra solo una vez, al crearse. Guárdelo de inmediato: no podrá volver a ver el valor completo.
    </Warning>
  </Step>

  <Step title="Cerrar el cuadro de diálogo">
    Haga clic en **Close**. Se abrirá la página **cliente de API pública**, donde podrá configurar el nuevo cliente.
  </Step>
</Steps>

<div id="configuring-a-public-api-client">
  ## Configurar un cliente de API pública
</div>

Después de crear un cliente de API pública, configure su configuración.

Para abrir la configuración de un cliente, haga clic en el nombre del cliente en la página **Public API Client**, o búsquelo por el nombre del cliente o por los roles del principal de la aplicación.

<Frame>
  <img src="https://mintcdn.com/abbyy/vsKEkGDuRLNqo_T3/images/vantage/tenant-admin/admin_managingrestapiclients_createclient3.png?fit=max&auto=format&n=vsKEkGDuRLNqo_T3&q=85&s=bf29027d53015de3f7735b7b82ab58af" alt="Página de configuración de OAuth 2.0 de Public API Client" style={{ width: "70%" }} width="1411" height="783" data-path="images/vantage/tenant-admin/admin_managingrestapiclients_createclient3.png" />
</Frame>

<Steps>
  <Step title="Asigne un nombre al cliente">
    En el campo **Client Name**, introduzca un nombre que identifique a este cliente.
  </Step>

  <Step title="Administre secretos">
    Haga clic en **Add Secret** para crear un nuevo secreto de cliente. De forma predeterminada, el nuevo secreto vence en 6 meses; puede establecer un vencimiento de entre 1 día y 36 meses.
  </Step>

  <Step title="Agregue direcciones URL de redirección">
    Haga clic en **Add Redirect URL** e introduzca cada URL a la que quiera permitir redirecciones de autorización.
  </Step>

  <Step title="Configure los flujos de OAuth 2.0">
    En la sección **OAuth 2.0 Flows Settings**, seleccione uno o varios flujos que el cliente pueda usar:

    * **Allow Authorization Code Flow** — un esquema de autenticación seguro en el que la aplicación envía la solicitud de autenticación directamente al servidor de autorización de Vantage. El servidor verifica las credenciales y devuelve un código de autorización. Este flujo está habilitado para todos los clientes de la Vantage API.
      * **Require PKCE for Authorization Code Flow** — refuerza la seguridad de los clientes públicos al permitir que Vantage verifique que la aplicación que solicita el token de acceso es la misma que inició la autenticación.
    * **Allow Resource Owner Password Credentials Flow** — permite a los usuarios autenticarse con su nombre de usuario y contraseña. La aplicación tiene acceso directo a la contraseña del usuario, así que úselo solo con aplicaciones en las que el usuario confíe plenamente.
    * **Allow issuing refresh tokens to refresh access tokens** — permite que el cliente emita tokens de actualización para renovar tokens de acceso sin volver a solicitar la autenticación del usuario. Las aplicaciones deben almacenar los tokens de actualización de forma segura.
    * **Allow client credentials flow** — concede a las aplicaciones acceso a la Vantage API mediante el flujo OAuth 2.0 Client Credentials. Los roles se determinan mediante la configuración **Manage Roles** situada debajo de esta opción.

    <Note>
      El flujo Resource Owner Password Credentials no funciona cuando hay un proveedor de identidades externo configurado. Consulte [Authentication](/es/vantage/documentation/tenant-admin/tenant-management/authentication).
    </Note>
  </Step>

  <Step title="Establezca la duración de los tokens">
    En la sección **Token Lifetime Settings**, configure lo siguiente:

    * **Access Token** — el período durante el cual un token de acceso emitido concede acceso a Vantage. Predeterminado: 24 horas.
    * **Refresh Token** — el período absoluto, a partir de la emisión del primer token de acceso, durante el cual el token de actualización puede renovar el token de acceso. Predeterminado: 30 días.
  </Step>
</Steps>

Para obtener más información sobre los flujos de autenticación, consulte [Authentication](/es/vantage/documentation/tenant-admin/tenant-management/authentication).

<div id="deleting-a-public-api-client">
  ## Eliminación de un cliente de API pública
</div>

Para eliminar un cliente, haga clic en el icono correspondiente en la página **cliente de API pública** y luego en **Delete Client**.

<Frame>
  <img src="https://mintcdn.com/abbyy/vsKEkGDuRLNqo_T3/images/vantage/tenant-admin/admin_managingrestapiclients_createclient5.png?fit=max&auto=format&n=vsKEkGDuRLNqo_T3&q=85&s=965ae7500be7c00a4a1096a6ad1254dd" alt="Página cliente de API pública con el botón Delete Client resaltado en la barra de herramientas del cliente" style={{ width: "74%" }} width="937" height="166" data-path="images/vantage/tenant-admin/admin_managingrestapiclients_createclient5.png" />
</Frame>

<div id="related-topics">
  ## Temas relacionados
</div>

* [Administración de clientes de Vantage API](/es/vantage/documentation/tenant-admin/tenant-management/manage-api-clients)
* [Autenticación](/es/vantage/documentation/tenant-admin/tenant-management/authentication)
