

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Configurar la autenticación de concesión de credenciales de cliente para Box
<a name="kb-managed-box-ccg-setup"></a>

La autenticación de concesión de credenciales de cliente (`CCG`) es el método de autenticación recomendado para una fuente de datos de Box. El conector se autentica como una aplicación de Box mediante el flujo de concesión de credenciales de cliente (2LO), con una cuenta de servicio (no un usuario) que rastrea todo el contenido empresarial y no permite iniciar sesión de forma interactiva. Es el único método de autenticación que admite el control de acceso a nivel de documento (ACL). Úselo para la mayoría de las implementaciones.

## Paso 1: Crea la aplicación Box
<a name="kb-managed-box-ccg-step1"></a>

1. Navega hasta la consola para desarrolladores de [ Box](https://app.box.com/developers/console).

1. Seleccione ** Crear una aplicación nueva**.

1. En Método ** de autenticación**, selecciona Autenticación ** del servidor**.

1. Seleccione Concesión de credenciales de ** cliente ** (marcada como ** recomendada ** en la casilla).

1. Asigne un nombre a la aplicación y elija ** Crear**. Se le redirigirá a la página de configuración.

## Paso 2: Configurar los permisos de la aplicación
<a name="kb-managed-box-ccg-step2"></a>

**Nivel de acceso**: en Nivel de acceso a la ** aplicación**, seleccione ** Aplicación \+ Acceso empresarial**.

**importante**  
Sin el acceso a App \+ Enterprise, la cuenta de servicio no puede ver todos los datos empresariales y el conector no se puede rastrear.

**Acciones de contenido (obligatorio)**: habilite las dos opciones siguientes:
+ Lea todos los archivos y carpetas
+ Escribe todos los archivos y carpetas

**importante**  
Box trata las descargas como una interacción de escritura, por lo que ** es necesario ** escribir incluso cuando se rastrea solo para leer.

**Acciones administrativas**: habilite las dos opciones siguientes:
+ Administrar usuarios de 
+ Administrar grupos

**nota**  
Se requieren acciones administrativas para admitir el control de acceso a nivel de documentos (ACL). Si no necesita las ACL, puede omitirlas. Box solo ofrece el conjunto completo de permisos de administración; no hay una opción de solo lectura.

**Configuración adicional**: habilite ** realizar llamadas a la API mediante el encabezado as-user. ** Esto permite que el conector delegue como usuarios individuales y rastree el contenido por usuario. Deje desactivada la ** opción Generar tokens ** de acceso de usuarios.

## Paso 3: Guarda y recopila las credenciales
<a name="kb-managed-box-ccg-step3"></a>

1. Seleccione **Save**. Verá una ** confirmación de que ** la configuración de la aplicación se guardó correctamente.

1. En el panel derecho (Detalles de ** la aplicación ** > ** Acceso**), copia el ID de ** cliente**.

1. Selecciona ** Fetch Secret ** para revelar el secreto del ** cliente y, a continuación**, cópialo.
**nota**  
El secreto del cliente no se muestra automáticamente después de la creación. Debes elegir ** Fetch Secret ** para revelarlo. Hazlo inmediatamente después de guardar, antes de salir de la página.

1. Desplázate hacia abajo hasta ** Propiedades ** en el panel derecho y recopila el ID ** de usuario ** (`ccgUserId`) y el ID de ** empresa ** (`enterpriseId`).

## Paso 4: Autorizar la aplicación
<a name="kb-managed-box-ccg-step4"></a>

Después de guardar, el ** panel de ** estado de la derecha muestra la ** autorización: no se envió ** con un ** botón de ** autorización.

1. Selecciona ** Autorizar ** para enviarlo para su revisión por parte del administrador.

1. Un administrador empresarial debe aprobar la aplicación para poder utilizarla.

**importante**  
La aplicación no funciona hasta que se conceda la autorización del administrador. **Si no se ha enviado, ** significa que la aplicación falla durante el tiempo de ejecución.

## Paso 5: Crea el secreto de Secrets Manager
<a name="kb-managed-box-ccg-step5"></a>

Guarde las credenciales en un AWS Secrets Manager secreto con los siguientes pares clave-valor:

```
{
    "clientId": "{{your-client-id}}",
    "clientSecret": "{{your-client-secret}}",
    "enterpriseId": "{{your-enterprise-id}}",
    "ccgUserId": "{{your-user-id}}"
}
```


**Campos secretos de CCG**  

| Campo | Description (Descripción) | 
| --- | --- | 
| clientId | ID de cliente de la aplicación en la  sección  Acceso (panel derecho). | 
| clientSecret | Se revela al seleccionar  Fetch Secret  después de guardar la aplicación. | 
| enterpriseId | Desde el  panel de  propiedades. Identifica la instancia empresarial de Box que se va a rastrear. | 
| ccgUserId | Desde el  panel de  propiedades. Valida que las credenciales puedan delegarse como usuario. | 

Cree el secreto con: AWS Command Line Interface

```
aws secretsmanager create-secret \
  --name {{bedrock-box-ccg-creds}} \
  --secret-string file://secret.json
```

Registra el ARN secreto de la respuesta. Lo usa como fuente `secretArn` de datos.

## Siguientes pasos
<a name="kb-managed-box-ccg-next"></a>

Después de almacenar el secreto, cree la fuente de datos con el `authType` valor establecido en`CCG`. Consulte [Conectar una fuente de datos de Box](kb-managed-ds-box-connect.md). Para filtrar los resultados de las consultas por permisos de usuario, consulte[Document-level controles de acceso](kb-managed-ds-box-acl.md).