Pular para o conteúdo principal
Procore

Editar uma conta de serviço

  1. Última atualização
  2. Salvar como PDF
 Pôr do sol das contas de serviço tradicionais

Todas as contas de serviço tradicionais terão o fim do contrato em 31 de dezembro de2024.

As contas de serviço tradicionais foram descontinuadas em 9 de dezembro de 2021. A partir de 1.º de outubro de 2024, não permitiremos mais a criação de novas contas de serviço tradicionais. As contas de serviço tradicionais existentes continuarão funcionando até 31 de dezembro de 2024.

De acordo com esta linha do tempo, os desenvolvedores de aplicativos de conexão de dados que atualmente usam contas de serviço tradicionais são obrigados a atualizar seus aplicativos para usar <a target="_blank" title=" " href.path="//faq/what-is-developer-managed-service-account" href.nome de arquivo..."> Contas de serviço gerenciadas pelo Usuário, e os clientes deverão instalar esses aplicativos atualizados antes da data de desmarcação. Todos os aplicativos de conexão de dados não migrados pela data de desmarcando deixarão de funcionar. Qualquer aplicativo listado no App Marketplace do Procore que não esteja usando um método compatível para acessar a API Procore será removido pela data de desativação. Consulte Migrando aplicativos de conexão de dados para usar DMSAs para obter informações adicionais.

Objetivo

Editar e atualizar um conta de serviço usando a ferramenta Administrador da empresa.

Fundo

As contas de serviços permitem oferecer suporte a integrações que exigem o fluxo de concessão de credenciais do cliente, conforme definido no memorial descritivo do marco 2.0 do IETF. Nesse cenário, os aplicativos precisam de uma maneira para recuperar um token de acesso OAuth 2.0 fora do contexto de qualquer usuário específico do Procore. O OAuth 2.0 fornece o tipo de concessão de credenciais do cliente para essa finalidade. Uma client_id e uma client_secret exclusiva é gerada quando uma nova conta de serviço é criada. Para obter informações sobre como implementar o fluxo de concessão de credenciais do cliente em um aplicativo, consulte OAuth 2.0 Usando as credenciais do cliente em nosso Portal do desenvolvedor.

Coisas a considerar

  • Permissão de usuário necessária:
    • Permissões de nível "Administrador" na ferramenta Administrador da empresa.
  • Considerações de acesso:
    • Uma nova conta de serviço consiste em:
      • client_id. O identificador da conta de serviço.
      • client_secret. O segredo é um código gerado aleatoriamente que será usado pela conta de serviço. Ela só fica visível para você no momento da criação da conta. Talvez você queira observar a client_secret e salvá-la em um local seguro caso exija referência no futuro. 
        Importante! Se por algum motivo você perder o client_secret, a Procore recomenda a criação de uma nova conta de serviço. 
      • Novas contas de serviço são criadas sem permissões ("Nenhuma") por padrão. Para alterar essas permissões, consulte Configurar permissões da conta de serviço.
  • Considerações importantes do Diretório da empresa:
    • Após criar um conta de serviço, o endereço de e-mail associado não poderá ser alterado no Diretório da empresa. Se você modificar o endereço de e-mail conta de serviço, a conta de serviço deixará de ser funcional.
    • Não é possível adicionar o contato conta de serviço a mais de um Diretório da empresa (apenas o diretório no qual foi criado) ou então ele vai parar de funcionar.

Passos

  1. Acesse a ferramenta Administrador de nível de empresa.
  2. Em "Definições da empresa", clique em Contas de serviço.
  3. Localize a conta de serviço deseja modificar e clique em Editar.

modify-service-account.png

  1. Altere o Tipo de aplicativo ou modifique o Nome conforme necessário e clique em Atualizar.

modify-service-account-update.png