Saltar al contenido principal
Procore

Crear una cuenta de servicio

Objetivo

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

Contexto

Las cuentas de servicios le permiten admitir integraciones que requieren el flujo de concesión de credenciales de cliente como se define en la Especificación del marco IETF OAuth 2.0. En este escenario, las aplicaciones necesitan una forma de recuperar un token de acceso de OAuth 2.0 fuera del contexto de cualquier usuario de Procore específico. 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 únicos cuando se crea una nueva cuenta de servicio. Para obtener información sobre cómo implementar el flujo de concesión de Credenciales de cliente en una aplicación, consulte OAuth 2.0 Uso de credenciales de cliente en nuestro Portal para desarrolladores.

Cosas para considerar

  • Permiso de usuario requerido:
    • Permisos de nivel "Administrador" en la herramienta Administrador de la compañía.
  • Consideraciones de acceso:
    • Una nueva cuenta de servicio consta de:
      • id_cliente. 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 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

  1. Navegue hasta la herramienta Administrador a nivel compañía.
  2. En "Configuración de la compañía", haga clic en Cuentas de servicio.
  3. En la página Cuentas de servicio, haga clic en +Nuevo.
  4. 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.

create-service-account.png

  1. Ingrese un Nombre para su nueva cuenta de servicio y haga clic en Crear. El client_id y client_secret para la cuenta de servicio se generan y están disponibles para su uso en la realización de llamadas al extremo de la API /oauth/token de Procore.
  2. 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 de servicio antes de usarla 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.
  • ¿Le ha resultado útil este artículo?