--- title: "Descripción general y terminología" url: https://docs.catalyst.zoho.com/es/api/oauth2/overview-and-terminology/ description: "Conoce el protocolo estándar de la industria OAuth 2.0 que utiliza Catalyst para autenticar y autorizar las solicitudes de API realizadas por los usuarios y obtener acceso seguro a los recursos protegidos de Catalyst." last_updated: 2026-08-06T05:54:02Z service: All Services type: api --- # Autenticación OAuth 2.0 ### Descripción general OAuth 2.0 es un protocolo estándar de la industria para autenticación y autorización. El framework permite que una serie de aplicaciones cliente de terceros obtengan acceso seguro y delegado a recursos protegidos en Zoho a través de APIs. Algunas características comunes de OAuth 2.0 son: - Los clientes no necesitan admitir la autenticación por contraseña ni almacenar credenciales de usuario. Se pueden realizar llamadas a la API para acceder a recursos sin tener que proporcionar credenciales de usuario en cada llamada. - Los clientes solo tendrán acceso a los recursos autenticados por el usuario. - Los usuarios pueden revocar el acceso delegado del cliente en cualquier momento. - Los access tokens de OAuth 2.0 expiran después de un tiempo establecido, lo que proporciona una seguridad sólida. ### Terminología Antes de aprender sobre los pasos involucrados en la implementación de OAuth 2.0, debes comprender los siguientes términos relacionados con OAuth 2.0 en el contexto de Catalyst:
| Términos clave | Descripción |
|---|---|
| Protected Resource | Un recurso de Catalyst como Cache, Cron, Table o Folder |
| Resource Server | El servidor de Catalyst que aloja los recursos protegidos de Catalyst |
| Client | Una aplicación que envía solicitudes al servidor de recursos para acceder a los recursos protegidos en nombre del usuario final |
| `client_id` | La clave única generada para un cliente registrado |
| `client_secret` | El valor secreto generado para el `client_id` de un cliente registrado específico. Cuando registras tu aplicación de Catalyst en la consola de API de Zoho, se generarán un `client_id` y un `client_secret` para ella. |
| Authentication Server | El servidor de autorización de Catalyst que proporciona las credenciales necesarias a un cliente, como el `access_token` o el `refresh_token` |
| Grant Token o `code` | El servidor de autorización de Catalyst genera un token temporal y lo envía al cliente a través del navegador. El cliente enviará este código de vuelta al servidor de autorización para obtener los access y refresh tokens. |
| `access_token` | Un token temporal que se envía al servidor de recursos para acceder a los recursos protegidos del usuario. Los clientes usan el `access_token` para realizar solicitudes a la aplicación asociada usando las APIs. Cada `access_token` será válido por un período de tiempo establecido y solo se puede usar para realizar las operaciones descritas en el scope. |
| `refresh_token` | Un token que se puede usar para obtener nuevos access tokens. Este token tiene una duración ilimitada hasta que sea revocado por el usuario final. |
| Scopes | Los scopes controlan el tipo de recursos a los que la aplicación cliente puede acceder. Cada token generalmente se crea con scopes seleccionados para una mejor seguridad. Por ejemplo, puedes generar un `access_token` con un scope para solo leer los datos en Data Store. El formato estándar para definir un scope es `scope=service_name.scope_name.operation_type`. La siguiente sección lista los scopes disponibles en Catalyst. |