Crear una cuenta de servicio

Objetivo

Crear una cuenta de servicio utilizando la herramienta Administrador de la compañía.

Fondo

Servicio cuentas le permite admitir integraciones que requieren que las Credenciales del cliente otorguen flujo según se define en la especificación IETF OAuth 2.0 Framework.En este escenario, las aplicaciones necesitan una forma de recuperar un token de acceso de OAuth 2.0 fuera del contexto de cualquier usuario específico de Procore. OAuth 2.0 proporciona el tipo de concesión de credenciales de cliente para este propósito. Se genera un client_id y client_secret único cuando se crea un nuevo cuenta de servicio. Para obtener información sobre cómo implementar las credenciales del cliente otorguen flujo en una aplicación, consulte OAuth 2.0 Usando credenciales de cliente en nuestro portal para programadores.

Aspectos a tener en cuenta

Permiso de usuario requerido:
- Permisos de nivel "Administrador" en la herramienta Administrador de la compañía.
Consideraciones de acceso:
- Una nueva cuenta de servicio está compuesta por lo siguiente:
  - client_id. El identificador de la cuenta de servicio.
  - client_secret. El secreto es un código generado aleatoriamente que será utilizado por la cuenta de servicio. Solo es visible para usted en el momento en que se crea la cuenta. Le sugerimos anotar el client_secret y luego guardarlo en una ubicación segura por si lo necesita en el futuro como referencia.
    ¡Importante! Si por alguna razón pierde el client_secret, Procore recomienda seguir los pasos a continuación para crear una nueva cuenta de servicio.
  - Las nuevas cuentas de servicio se crean sin permisos ("Ninguno") por defecto. Para cambiar estos permisos, consulte Configurar permisos de cuentas de servicio.
Consideraciones importantes del Directorio de compañía:
- Una vez que crea una cuenta de servicio, la dirección de correo electrónico asociada no debe cambiarse en el directorio de la compañía. Si modifica la dirección de correo electrónico de la cuenta de servicio, la cuenta de servicio dejará de ser funcional.
- El contacto de la cuenta de servicio no puede añadirse a más de un directorio de compañía (solo al directorio en el que fue creado), o de lo contrario dejará de funcionar.

Pasos

Vaya a la herramienta Administrador a nivel compañía.
En "Configuración de la compañía", haga clic en Cuentas de servicio.
En la página Cuentas de servicio, haga clic en +Nuevo.
Especifique un "Tipo de aplicación". Si va a utilizar esta cuenta de servicio con una aplicación de Marketplace específica, seleccione la opción Marketplace y elija la aplicación adecuada de la lista desplegable. De lo contrario, seleccione Personalizado.

Ingrese un nombre para su nueva cuenta de servicio y haga clic en Crear. Los client_id y client_secret para la cuenta del servicio se generan y están disponibles para su uso en la realización de llamadas al punto final API/oauth/token de Procore.
Configure los permisos de la cuenta de servicio.Debido a que la cuenta de servicio no tiene permisos a nivel compañía cuando se crea por primera vez, debe establecer los permisos adecuados para la cuenta del servicio antes de usarlo para acceder a la API de Procore.

Importante

Tenga en cuenta que, aunque es posible que pueda generar un token de acceso de OAuth 2.0 utilizando una cuenta de servicio sin permisos ("Ninguno"), este token no funcionará para realizar llamadas exitosas a la API de Procore. Por lo tanto, debe establecer los permisos adecuados para la cuenta de servicio antes de usarla para acceder a la API de Procore.