Gerenciar chaves de API

IMPORTANT
A Workfront não recomenda mais o uso das chaves de API ou do ponto de acesso /login. Em vez disso, use um dos seguintes métodos de autenticação:
  • Autenticação do servidor com JWT
  • Autenticação de usuário com OAuth2
Para obter instruções sobre como configurar esses métodos de autenticação, consulte Criar aplicativos OAuth2 para integrações do Workfront.
Para obter instruções sobre como usar a autenticação de servidor no Workfront, consulte Configurar e usar os aplicativos OAuth2 personalizados da sua organização usando o fluxo JWT.
Para obter instruções sobre como usar a autenticação de usuário no Workfront, consulte Configurar e usar os aplicativos OAuth2 personalizados de sua organização usando o fluxo de código de autorização.

Para minimizar as vulnerabilidades de segurança da API, os administradores do Adobe Workfront podem gerenciar as Chaves de API usadas para permitir que os aplicativos acessem o Workfront em nome de um usuário.

Você pode redefinir ou remover sua Chave de API do administrador atual, configurar as Chaves de API para expirar e remover as Chaves de API para todos os usuários.

Exemplos de aplicativos que usam a API do Workfront são:

  • Integrações de documentos, como Dropbox, Google Drive e Workfront DAM
  • aplicativos móveis Workfront
IMPORTANT
Ao redefinir ou remover uma Chave de API, qualquer aplicativo que use a API do Workfront e seja autenticado no Workfront por meio dessa Chave de API deve ser reconfigurado para recuperar o acesso ao Workfront.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Padrão

Plano

Configurações de nível de acesso Você deve ser um administrador do Workfront.

Para obter informações, consulte Requisitos de acesso na documentação do Workfront.

Chaves de API do Workfront

Cada usuário no Workfront tem uma chave de API exclusiva. Essa chave é gerada com base no usuário no momento em que o usuário acessa uma integração que aproveita a API do Workfront (como o aplicativo móvel Workfront ou uma integração de documentos).

NOTE
As chaves de API geradas no ambiente de produção são copiadas para o ambiente de Pré-visualização durante a atualização semanal. Quaisquer chaves de API geradas no ambiente de Pré-visualização serão substituídas pelas chaves de API de produção durante a atualização semanal.

Os administradores do Workfront também têm uma chave de API exclusiva. Quando um aplicativo usa uma chave de API de administrador para acessar o Workfront, ele tem acesso de administrador ao Workfront.

Gerenciar uma chave de API do administrador

Você pode gerar, redefinir ou remover a Chave de API da conta de usuário administrador.

  1. Clique no ícone Menu Principal Menu Principal no canto superior esquerdo do Adobe Workfront e clique no ícone Instalação Instalação .

  2. Clique em Sistema > Informações do Cliente.

  3. (Condicional) Execute uma das seguintes ações:

    Para gerar uma Chave de API: Na seção Configurações da Chave de API, clique em Gerar Chave de API.

    Ou
    Para redefinir uma Chave de API: Na seção Configurações da Chave de API, clique em Redefinir e depois em Redefinir.

    Ou

    Para remover a Chave de API: Na seção Configurações da Chave de API, clique em Remover e depois em Remover.

Configurar quando as chaves de API expiram

Você pode configurar as Chaves de API para expirarem para todos os usuários em seu sistema. Quando a chave de API de um usuário expira, o usuário deve se autenticar novamente em qualquer aplicativo que use a API do Workfront para acessar o Workfront. Você pode alterar a frequência com que as Chaves de API expiram. Você também pode configurar se as Chaves de API expiram quando a senha de um usuário expira.

  1. Clique no ícone Menu Principal Menu Principal no canto superior esquerdo do Adobe Workfront e clique no ícone Instalação Instalação .

  2. Clique em Sistema > Informações do cliente.

  3. Na área Configurações da Chave de API, na lista suspensa Após a criação, as chaves de API expiram em, selecione o período em que deseja que as chaves de API expirem.

    Ao alterar essa opção, o novo período começa a partir do momento em que você fez a alteração. Por exemplo, se você alterar esta opção de 1 mês para 6 meses, as Chaves de API expirarão em 6 meses a partir do momento em que você fizer a alteração.

    Por padrão, as Chaves de API expiram a cada mês.

  4. Para configurar as Chaves de API para expirarem no momento em que as senhas dos usuários expirarem, habilite Remover chave de API quando a senha de um usuário expirar.

    Por padrão, essa opção não está ativada.

    Para obter informações sobre como configurar senhas de usuário para expirar, consulte Configurar preferências de segurança do sistema.

  5. Clique em Salvar.

Remover as chaves de API de todos os usuários

Se você estiver preocupado com uma violação de segurança específica em relação ao seu sistema Workfront, poderá remover as Chaves de API simultaneamente para todos os usuários.

IMPORTANT
Remover as chaves de API de todos os usuários invalida TODAS as chaves de API de todos os usuários do sistema. Essa ação causará falha em todas as suas integrações no Workfront até que você gere uma nova Chave de API no Workfront e atualize todas as suas integrações.
  1. Clique no ícone Menu Principal Menu Principal no canto superior esquerdo do Adobe Workfront e clique no ícone Instalação Instalação .

  2. Expanda Sistema e clique em Informações do cliente.

  3. Na área Configurações da Chave de API, clique em Remover todas as chaves de API e em Remover Tudo.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43