Configure o. SuccessFactors spoke v4.x.x

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 10 min. de leitura

    • Integre o. ServiceNow instância com seu SuccessFactors Instância que usa a aplicação cliente OAuth e a chave de API.

    Antes de Iniciar

    • Solicitar uma assinatura de IntegrationHub.
    • Ative o. SuccessFactors spoke.
    • Habilite estas propriedades do sistema:
      • glide.pf.rest.response_payload_max_size: O valor máximo é, 10240 .
      • com.snc.process_flow.reporting.serialized.val_size_limit: O valor máximo é, 16384 .
      • com.glide.transform.json.max-partial-length: O valor máximo é, 65536 .
    • Função necessária: administrador
    Nota:
    Este procedimento será aplicável se você estiver configurando o. SuccessFactors spoke v 4.10.1 pela primeira vez. Se você estiver usando uma versão anterior do SuccessFactors spoke, consulte Migrar para SuccessFactors spoke v 4.10.1 para o procedimento de migração.

    Para obter mais informações sobre como configurar o spoke, consulte Spoke do SAP SuccessFactors - Configuração e migração do OAuth - Pré-Tóquio, Tóquio e além em ServiceNow Comunidade.

    Registrar a aplicação cliente OAuth em SuccessFactors

    Habilite a autenticação de certificado de cliente para a comunicação de saída gerando keystore.jks e. armazenamento de chaves arquivos .cer.

    Antes de Iniciar

    • Gere um certificado JKS válido. Para obter informações sobre como criar um certificado JKS, consulte Criando Java KeyStore (JKS) com Chave privada e Cadeia de certificados em SAP Portal de Ajudaou execute as etapas.
      1. Use o comando openssl genrsa -out private.key 2048 para gerar o arquivo private.key.
      2. Use o private.key para criar o certificado x.509 (arquivo .cer) que contém sua chave pública.

        Use o comando openssl req -new -x509 -key private.key -out publickey.cer -days 365

    • Converta a chave pública e privada em um arquivo .p12.

      Use o comando para executar a etapa acima openssl pkcs12 -export -in publickey.cer -inkey private.key -out successfactors.p12 -name "".

    • Converta o arquivo .p12 em .jks

      Use o comando para executar a etapa acima keytool -importkeystore -srckeystore successfactors.p12 -srcstoretype pkcs12 -destkeystore successfactors.jks .

    • Função necessária: administrador

    Procedimento

    1. Faça login no SuccessFactors conta como administrador.
    2. Navegue até Central de administração e clique em Configurações da empresa .
    3. Clique em Gerencie aplicações do cliente OAuth2 .
    4. Clique em Registrar aplicação do cliente .
      Registre uma aplicação cliente.
    5. Forneça os detalhes necessários no formulário.
      Em Certificado X.509 forneça o conteúdo do arquivo cert.pem (chave pública) sem os cabeçalhos.
    6. Clique em Enviar.
      Chave de API é gerado e exibido. Copie e registre o valor para uso posterior.

    Carregue o certificado JKS em seu ServiceNow instância

    Habilite a autenticação de certificado de cliente para a comunicação de saída carregando o certificado JKS em seu ServiceNow instância.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Faça login em ServiceNow instância como administrador.
    2. Carregue o certificado do JKS para seu ServiceNow instância.
      Para obter instruções sobre como carregar o certificado JKS, consulte Carregue um certificado em uma instância .
      Carregue o certificado JKS.

    Registrar SuccessFactors como um provedor OAuth

    Use a chave de API gerada durante a configuração da aplicação cliente para registrar a aplicação como um provedor de OAuth.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em seu ServiceNow instância, navegue até OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
    3. Preencha estes campos no formulário.
      Campo Descrição
      Nome Nome exclusivo para identificar o certificado. Por exemplo, SAML SuccessFactors .
      ID de cliente Valor da chave de API que você copiou após registrar a aplicação cliente OAuth em SuccessFactors.
      Segredo do cliente
      Nota:
      O segredo do cliente não é necessário para registrar a aplicação como um provedor de OAuth. Você pode fornecer qualquer valor para este campo.
      Script do API do OAuth Nome do script da API OAuth. Pesquisar OAuthUtilSuccessFactors e selecione-o na lista.
      Tipo de concessão padrão Tipo de concessão padrão usado para estabelecer o token. Selecione Portador do SAML2 .
      URL de Token SuccessFactors URL do endpoint do servidor OAuth que inclui o ID da empresa neste formato: <Company_ID>://<SuccessFactors_Instance_Name>/oauth/token?company_id . Por exemplo, https://example.successfactors.eu/oauth/token?company_id=SFCPART123456 .
      Registro da aplicação.
    4. Clique em Enviar.

    Crie o registro do produtor de asserção do SAML2

    Crie um registro de asserção do SAML2 para gerar a asserção do SAML2 e trocar a asserção pelos tokens de acesso com o provedor.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Crie um registro do produtor de asserção do SAML2 em seu ServiceNow instância.
      1. Navegar até Tudo > OAuth de Sistema > Produtores de asserção do SAML2.
      2. Clique em Nova.
      3. No formulário, preencha estes valores.
        Campo Descrição
        Nome Nome exclusivo para identificar o registro do produtor de asserção do SAML2. Por exemplo, OAuth de SAML do fator de sucesso .
        Emissor Identificador exclusivo da entidade emissora de asserção. Forneça o. ServiceNow URL da instância.
        Nome do assunto Nome de usuário para fazer login no SuccessFactors instância. Por exemplo, sfadmin .
        Público Público-alvo da asserção. Insira o valor, www.successfactors.com .
        Destinatário Destinatário pretendido para a asserção. Insira o URL neste formato, https://<SuccessFactors-Instance-Name>/oauth/token .
        Registro do produtor de asserção do SAML2.
      4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      5. Em Armazenamentos de chaves de asserção do SAML2 clique em Novo .
      6. No formulário, preencha estes valores.
        Campo Descrição
        Nome Nome exclusivo para identificar o registro do armazenamento de chaves de asserção do SAML2. Por exemplo, sap_successfactor .
        Alias das chaves de assinatura Alias da entrada de chave armazenada no armazenamento de chaves usado para assinar a declaração. Por exemplo, 1 .
        Senha da chave de assinatura Senha da entrada de chave armazenada no armazenamento de chaves usado para assinar a declaração.
        Armazenamento de chaves de assinatura Registro de certificado X.509 obrigatório. Selecione o registro de certificado X.509 que você criou anteriormente. Para obter mais informações, consulte Carregue o certificado JKS em seu ServiceNow instância.
        Registro do armazenamento de chaves de asserção do SAML2.
      7. Clique em Enviar.
      8. Navegar até Tudo > OAuth de Sistema > Produtores de asserção do SAML2.
      9. Abra o registro do produtor de asserção do SAML2 que você criou.
        Por exemplo, OAuth de SAML do fator de sucesso .
      10. Em Atributos de asserção do SAML2 clique em Novo .
      11. No formulário, preencha estes valores.
        Campo Descrição
        Nome Nome para identificar o registro de atributo de asserção do SAML2. Insira api_key .
        Tipo Tipo de Valor campo. Selecione Cadeia de caracteres .
        Valor Chave de API gerada depois que a aplicação cliente OAuth é criada em SuccessFactors.
        Registro de atributo de asserção do SAML2.
      12. Clique em Enviar.
    2. Associe o produtor de asserção do SAML2 ao registro de registro da aplicação.
      1. Navegar até OAuth de Sistema > Registro de aplicações.
      2. Abra o registro de registro da aplicação que você criou.
        Por exemplo, Registro de OAutors SuccessFactors . Para obter mais informações sobre como criar o registro da aplicação, consulte Registrar SuccessFactors como um provedor OAuth.
      3. Em Perfis de entidade OAuth Abra o registro de perfil de entidade OAuth padrão.
        Por exemplo, Padrão_profile de SAML de fator de sucesso .
      4. Para Produtor de asserção Selecione o registro do produtor de asserção do SAML2 que você criou.
        Por exemplo, OAuth de SAML do fator de sucesso .
        Registro de perfil OAuth entiy.
      5. Clique em Atualizar.

    Crie registro de credencial para a API OData

    Crie registro de credencial para as APIs OData em SuccessFactors. . SuccessFactors spoke O alias de conexão e credencial usa essas credenciais para autorizar ações usando a API OData.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem: Que tipo de credenciais você deseja criar?
    3. Selecione Credenciais OAuth 2.0.
      Um formulário de Credenciais do OAuth 2,0 vazio é exibido.
    4. No formulário, preencha estes valores.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira SAML_SuccessFactors_OData_cred .
      Perfil de Entidade OAuth Registro de perfil de entidade OAuth associado ao registro da aplicação OAuth que você criou. Por exemplo, Padrão_profile de SAML de fator de sucesso .

      Para obter mais informações sobre como criar o registro da aplicação, consulte Registrar SuccessFactors como um provedor OAuth.
      Ativo Opção de usar ativamente o registro de credencial.
      Ordem A ordem na qual aplicar esta credencial. Por exemplo: insira 100.
      Registro de credencial do OData.
    5. Clique em Enviar.

    Resultado

    O registro de credencial para autorizar ações usando a API OData foi criado.

    Crie registro de credencial para a API SOAP

    Crie registro de credencial para as APIs SOAP em SuccessFactors. . SuccessFactors spoke O alias de conexão e credencial usa essas credenciais para autorizar ações usando as APIs SOAP.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem: Que tipo de credenciais você deseja criar?
    3. Selecione Credenciais OAuth 2.0.
      Um formulário de Credenciais do OAuth 2,0 vazio é exibido.
    4. No formulário, preencha estes valores.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira SAML_SuccessFactors_SOAP_cred .
      Perfil de Entidade OAuth Registro de perfil de entidade OAuth associado ao registro da aplicação OAuth que você criou. Por exemplo, Padrão_profile de SAML de fator de sucesso .

      Para obter mais informações sobre como criar o registro da aplicação, consulte Registrar SuccessFactors como um provedor OAuth.
      Ativo Opção de usar ativamente o registro de credencial.
      Ordem A ordem na qual aplicar esta credencial. Por exemplo: insira 100.
      Registro de credencial SOAP.
    5. Clique em Enviar.

    Resultado

    O registro de credencial para autorizar ações usando a API SOAP foi criado.

    Criar registro de conexão para a API OData

    Crie um registro de conexão para a API OData em SuccessFactors. . SuccessFactors spoke o alias de conexão e credencial usa essas conexões para executar ações em SuccessFactors.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Aberto para o registro de SuccessFactors OData .
      Por exemplo, SuccessFactors_OData .
    3. Em Conexões clique em Novo .
      O sistema exibe um formulário de conexão HTTP(s) vazio.
    4. No formulário, preencha estes valores.
      Tabela 1. Formulário de conexão HTTP
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, SAML_SuccessFactors_OData_Conn .
      Credencial Registro de credencial que você criou para a REST API. Por exemplo, SAML_SuccessFactors_OData_cred .
      URL de Conexão SuccessFactors URL da raiz do serviço neste formato: https://<SuccessFactors_Instance_Name>/odata/v2 . Por exemplo, https://example.successfactors.eu/odata/v2 .
      Nota:
      Se você estiver usando uma conta do SAP Cloud, consulte Lista de servidores de API SAP SuccessFactors em Portal de ajuda do SAP Para selecionar o endpoint correto necessário para direcionar o servidor de API.
      Ativo Opção para usar ativamente o registro de conexão.
      Registro de conexão OData.
    5. Clique em Enviar.

    Resultado

    O registro de conexão da REST API em SuccessFactors foi criado.

    Criar registro de conexão para a API SOAP

    Crie um registro de conexão para a API SOAP em SuccessFactors. . SuccessFactors spoke o alias de conexão e credencial usa essas conexões para executar ações em SuccessFactors.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Aberto para o registro de API de SOAP SuccessFactors .
      Por exemplo, SuccessFactors_Comp_emp .
    3. Em Conexões clique em Novo .
      O sistema exibe um formulário de conexão HTTP(s) vazio.
    4. No formulário, preencha estes valores.
      Tabela 2. Formulário de conexão HTTP
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, SAML_SuccessFactors_SOAP_Conn .
      Credencial Registro de credencial que você criou para a API SOAP. Por exemplo, SAML_SuccessFactors_SOAP_cred .
      URL de Conexão SuccessFactors URL de conexão. Por exemplo, https://<SuccessFactors_Instance_Name>/sfapi/v1/soap . Por exemplo, https://example.successfactors.eu/sfapi/v1/soap .
      Nota:
      Se você estiver usando uma conta do SAP Cloud, consulte Lista de servidores de API SAP SuccessFactors em Portal de ajuda do SAP Para selecionar o endpoint correto necessário para direcionar o servidor de API.
      Ativo Opção para usar ativamente o registro de conexão.
    5. Em Atributos forneça estes campos.
      Campo Descrição
      ID da empresa ID da empresa imutável do seu SuccessFactors instância.
      Tempo limite de fluxo (segundos) Tempo máximo em segundos até o qual os dados podem ser recebidos SuccessFactors durante a execução do fluxo. Se o tempo necessário para recuperar dados do SuccessFactors exceder a duração do tempo limite, o fluxo ou subfluxo será cancelado. O valor padrão é, 30 .
      Registro de conexão SOAP.
    6. Clique em Enviar.

    Resultado

    O registro de conexão da API SOAP em SuccessFactors foi criado.

    Sincronizar dados entre SuccessFactors e. ServiceNow

    Personalize os fluxos de amostra de acordo com seu requisito para sincronizar dados entre o. SuccessFactors e. ServiceNow instâncias.

    Tarefa pendente

    . SuccessFactors o spoke fornece fluxos de amostra para sincronizar dados bidirecionalmente para a entidade pendente. O fluxo de amostra Executar fluxo de integração SuccessFactors pode ser personalizado para recuperar dados de SuccessFactors, Enquanto os fluxos Criar tarefas pendentes e Atualizar tarefas criam ou atualizam os registros pendentes em SuccessFactors quando ocorrem eventos em ServiceNow. Ao personalizar os fluxos de amostra, forneça gatilhos apropriados para recuperar e salvar atualizações futuras usando mapas de transformação.

    Outras entidades padrão

    Para essas entidades, o fluxo de amostra, Executar fluxo de integração SuccessFactors, pode ser personalizado para recuperar dados de SuccessFactors:
    • Departamento
    • Local
    • Perfil do Trabalho
    • Perfil dos trabalhadores
    • Perfil efetivo dos trabalhadores
    • Histórico de trabalhos, incluindo atribuições secundárias

    Para criar ou atualizar registros em SuccessFactors para essas entidades quando eventos ocorrem em ServiceNow:

    • Crie fluxos ou subfluxos de acordo com sua escolha ou personalize os fluxos e subfluxos de amostra.
    • Use ações de Recuperação de metadados e Gestão de registros em seus fluxos.
    • Forneça gatilhos apropriados para recuperar e salvar atualizações futuras usando mapas de transformação.

    Outro SuccessFactors entidades

    Dependendo de SuccessFactors e configurações, você também pode sincronizar dados de outras entidades de acordo com sua necessidade.