Ir para o conteúdo principal
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Configuração de tarefas do SuccessFactors com credenciais OAuth

Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

Sobre a configuração de tarefas do SuccessFactors com credenciais OAuth

Você pode extrair dados do colaborador diretamente do SuccessFactors para a plataforma Qualtrics por meio do uso de tarefas de extração de fluxos de trabalho. No entanto, a SuccessFactors exige a configuração de um cliente OAuth2 para que a Qualtrics recupere dados de seu sistema. As ações de pré-requisito devem ser executadas pelo Portal de administração do SuccessFactors para configurar as tarefas de extração do Qualtrics pela primeira vez.

Etapa 1: criar um certificado X.509

Atenção: se você já tiver um certificado X.509 que pode utilizar para configurar o client de aplicação OAuth2, pode ignorar esta etapa.

Para gerar um novo certificado, a SuccessFactors recomenda o uso do OpenSSL com o seguinte comando:

requisição openssl -node -x509 -sha256 -newkey rsa:2048 -keyout private.pem -out public.pem
Qdica: os valores usados para algumas propriedades do certificado, como Nome da organização e Endereço de e-mail, não são validados e podem ser deixados em branco.

Mostra a geração de certificado no painel OpenSSL.

Após a execução deste programa, serão gerados dois arquivos de texto: public.pem e private.pem, que estão destacados acima. Para visualizar o conteúdo desses arquivos, você pode abri-los em qualquer editor de arquivo de texto. Alternativamente, use os comandos “ls” e “cat” no terminal OpenSSL.
Exibe as chaves de certificado geradas a serem copiadas na etapa 1.

  1. public.pem: Contém a chave pública para o certificado X.509. Isso será usado na configuração do cliente OAuth do Successfactors.
  2. private.pem: Contém a chave privada para o certificado X.509. Isso será usado durante a configuração das tarefas do fluxo de trabalho da Qualtrics.
Qdica: esses valores devem estar entre os delimitadores “—–BEGIN PRIVATE KEY—–” e “—–END PRIVATE KEY—–”.
Atenção: o Suporte Qualtrics não pode ajudar a configurar chaves de autenticação do SuccessFactors. Se precisar de ajuda extra, entre em contato com a equipe de suporte da SuccessFactors ou leia a documentação dela aqui.

Etapa 2: Registrar uma aplicação cliente OAuth2

  1. Efetue login na Central do administrador do SuccessFactors. Observe o domínio da API, a ID da empresa e o nome do usuário.
    Tela de login do Successfactors com os IDs de chave destacados.
  2. Clique em API Center (Centro API).
    Centro da API Successfactors
  3. Clique em Configuração OAuth para OData.
    Item de menu de configuração OAuth do Successfactors.
  4. Clique em Registrar aplicativo cliente.
    Botão Successfactors para registrar um novo cliente para autenticação.
  5. Cole a chave pública gerada a partir do certificado X.509 no espaço fornecido.
    O menu de configuração do OAuth destaca onde inserir a chave pública gerada na etapa 1.
  6. Clique em Registrar.
  7. Visualize a aplicação cliente OAuth2 recém-registrada.
    Onde visualizar o cliente autenticador de sucessores recém-criado.
  8. Copie e salve a chave API. Isso será utilizado na terceira etapa.
    HIghlights a chave API criada a partir do SuccessFactors. Isso precisará ser copiado.

Etapa 3: Configurar a conta do SuccessFactors na tarefa da Qualtrics

As etapas acima forneceram as informações necessárias para você seguir as instruções do fluxo de trabalho de extração de dados Qualtrics:
Mostra as informações necessárias para inserir uma tarefa de extração de dados do Qualtrics.

  1. Nome: nome descritivo para a conexão.
  2. Nome do usuário: seu ID de usuário SAP.
  3. Chave API: gerada pelo aplicativo OAuth2 registrado.
  4. Domínio do centro de dados: parte do domínio do URL da Central do administrador do SuccessFactors, mostrada na primeira etapa do registro de um aplicativo OAuth2.
  5. Chave privada de certificado 509: valor da chave privada gerada pela configuração do certificado X.509. A chave privada deve estar no formato PKCS8.
  6. ID da empresa: ID da empresa para a instância do SuccessFactors, mostrado na primeira etapa do registro de um aplicativo OAuth2.

Atualizando credenciais do SuccessFactors

Você não pode editar uma conexão depois que ela é adicionada ao fluxo de trabalho. Para atualizar as configurações de conexão, você deve criar uma nova conta e incorporar as edições necessárias. Abra sua tarefa de workflows e clique em Adicionar uma conta de usuário.
Mostra como adicionar uma nova conta ao painel de tarefas do fluxo de trabalho.

Se você não estiver mais usando sua conexão anterior, poderá excluí-la clicando nos três pontos no lado direito e selecionando Remover conta.
Exibe como remover uma conta do painel de tarefas de workflows.

Solução de problemas de erros de autenticação

Se as configurações de conexão OAuth estiverem incorretas, uma mensagem de erro será exibida quando você tentar salvar suas credenciais. Para resolver esses problemas, reconfigure a tarefa com as credenciais corrigidas seguindo os passos acima.

Código de erro Mensagem de erro Explicação
SFSF_2 Você não tem permissão para acessar APIs usando autenticação padrão ou OAuth neste servidor. Em vez disso, use o servidor API. O URL do servidor fornecido na configuração da conexão não é suportado com conexões OAuth e precisa ser atualizado. Novas credenciais precisarão ser configuradas usando um servidor dessa lista.

Se você não vir seu domínio nesta lista, entre em contato com o suporte da SuccessFactors.
SFSF_3 O domínio “{Domain}” associado à credencial da tarefa não é um domínio válido do SuccessFactors O campo de domínio da configuração de credencial não é válido. Novas credenciais precisarão ser configuradas.
SFSF_5 Credenciais não encontradas Não foi possível encontrar as credenciais associadas à configuração. Novas credenciais precisam ser configuradas.
SFSF_6 Campos de credenciais em falta As credenciais não estão configuradas corretamente. Para resolver, crie uma nova configuração seguindo as etapas acima.
SFSF_7 Esquema de autorização não suportado Indica a utilização de credenciais de esquema de autenticação básico. As credenciais de autenticação básica estão obsoletas e não funcionarão mais. Para resolver, crie novas credenciais seguindo as etapas acima.
SFSF_8 A chave privada deve estar no formato PKCS8 A chave privada do certificado X.509 fornecida não está no formato PKCS8 necessário. A chave privada deve ter o formato:

-----BEGIN PRIVATE KEY-----
 [dados-chave]
 -----END PRIVATE KEY-----

Se a chave não tiver este nome, copie e cole o comando OpenSSL:

openssl req -nodes -x509 -sha256
 -newkey rsa:2048 -keyout
 private.pem -out public.pem
SFSF_8 Código de resposta inesperado da solicitação para o URL: https://successfactors.com/oauth/token, status da resposta:401, erro: impossível autenticar o cliente (Falha no login – usuário inválido)

OU

Código de resposta inesperado da solicitação para o URL: https://successfactors.com/oauth/token, status de resposta:401, erro: impossível mapear “{ID do usuário” para um ID de usuário BizX válido

 O nome de usuário fornecido na configuração da conexão não é um ID de usuário SAP válido na instância SuccessFactors da empresa. No SAP, os nomes de usuário podem ser diferentes do ID do usuário e do ID da pessoa, embora sejam frequentemente os mesmos.
SFSF_8 Credenciais do cliente inválidas

OU

Impossível validar “api_key” na asserção SAML

 A chave API fornecida na configuração da conexão está incorreta.

Solução de problemas de erros de não autenticação

Se a execução do workflow mostrar um erro diferente, isso poderá indicar um problema de configuração incorreta não relacionado ao OAuth.

Código de erro Mensagem de erro Explicação
SFSF_1 As mensagens de erro podem variar com base no contexto do problema Ocorreu um erro inesperado. Entre em contato com o suporte da Qualtrics.
SFSF_2 Resposta inesperada da SuccessFactors. Verifique sua configuração e tente novamente Recebemos um erro que não reconhecemos da SuccessFactors. Isso indica um problema de configuração, portanto, verifique sua configuração e entre em contato com o suporte da Qualtrics se o erro persistir.
SFSF_2 As características “{PropertyName}” não estão acessíveis O “{PropertyName}” no SuccessFactors não está disponível pelo API OData do SuccessFactors. Para resolver, remova a característica da configuração e tente novamente.
SFSF_2 Nomes de característica inválidos: “{PropertyName}” “{PropertyName}” não existe em sua instância SuccessFactors. Remova a propriedade da configuração e tente novamente.

Muitas das páginas neste site foram traduzidas do inglês original usando tradução automática. Embora na Qualtrics tenhamos feito nossa diligência prévia para obter as melhores traduções automáticas possíveis, a tradução automática nunca é perfeita. O texto original em inglês é considerado a versão oficial, e quaisquer discrepâncias entre o inglês original e as traduções automáticas não são juridicamente vinculativas.