Configure o. SuccessFactors spokev4.x.x

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 10 min. de leitura

    • Integrar o. ServiceNow instância com seu SuccessFactorsInstâ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 spokev 4.6.0 pela primeira vez. Se você estiver usando uma versão anterior do SuccessFactors spoke, consulte Migrar para SuccessFactors spokev 4.6.0 para o procedimento de migração.

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

    Registre a aplicação cliente OAuth em SuccessFactors

    Habilite a autenticação de certificado de cliente para a comunicação de saída de SAP Serviço de dados mestres 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 SuccessFactorsconta como administrador.
    2. Navegue até Central de administração e clique em Configurações da empresa .
    3. Clique em Gerenciar aplicações cliente OAuth2 .
    4. Clique em Registrar aplicação 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 no seu ServiceNow instância como administrador.
    2. Carregue o certificado JKS para seu ServiceNow instância.
      Para obter instruções para carregar o certificado JKS, consulte Carregue um certificado em uma instância .
      Carregar certificado JKS.

    Registre-se SuccessFactorsComo 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 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, SuccessFactors SAML .
      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 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 do token SuccessFactorsURL do endpoint do servidor OAuth que inclui o ID da empresa neste formato: https://<SuccessFactors_Instance_Name>/oauth/token?company_id: <Company_ID> . Por exemplo, https://example.successfactors.eu/oauth/token?company_id=SFCPART123456 .
      Registro de registro da aplicação.
    4. Clique em Enviar.

    Crie o registro do produtor de declaração SAML2

    Crie um registro de declaração SAML2 para gerar a declaração SAML2 e trocar a declaração dos tokens de acesso com o provedor.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Crie um registro do produtor de declaração SAML2 em seu ServiceNow instância.
      1. Navegar até Tudo > OAuth de Sistema > Produtores de declaração de 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 declaração SAML2. Por exemplo, SAML OAuth do fator de sucesso .
        Emissor Identificador exclusivo da entidade emissora de declaração. Forneça o. ServiceNow URL da instância.
        NameID do assunto Nome de usuário para fazer login no SuccessFactors instância. Por exemplo, sfadmin .
        Público Público pretendido para a declaração. Insira o valor, www.successfactors.com .
        Destinatário Destinatário pretendido para a declaração. Insira a URL neste formato, https://<SuccessFactors-Instance-Name>/oauth/token .
        Registro do produtor de declaraçã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 necessá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 declaração do SAML2.
      7. Clique em Enviar.
      8. Navegar até Tudo > OAuth de Sistema > Produtores de declaração de SAML2.
      9. Abra o registro do produtor de declaração SAML2 que você criou.
        Por exemplo, SAML OAuth do fator de sucesso .
      10. Em Atributos de declaraçã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 declaração do SAML2.
      12. Clique em Enviar .
    2. Associe o produtor de declaraçã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 OAuth SuccessFactors . Para obter mais informações sobre como criar o registro da aplicação, consulte Registre-se SuccessFactorsComo um provedor OAuth.
      3. Em Perfis de entidade OAuth Abra o registro de perfil de entidade OAuth padrão.
        Por exemplo, SAML default_profile do Successfactor .
      4. Para Produtor de declaração , selecione o registro do produtor de declaração SAML2 que você criou.
        Por exemplo, SAML OAuth do fator de sucesso .
        Registro de perfil OAuth enth.
      5. Clique em Atualizar.

    Crie registro de credencial para a API OData

    Crie registro de credencial para as APIs OData em SuccessFactors. . SuccessFactors spokeO 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 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, SAML default_profile do Successfactor .

      Para obter mais informações sobre como criar o registro da aplicação, consulte Registre-se SuccessFactorsComo 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 OData.
    5. Clique em Enviar.

    Resultado

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

    Criar registro de credencial para a API SOAP

    Crie registro de credencial para as APIs SOAP em SuccessFactors. . SuccessFactors spokeO 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 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, SAML default_profile do Successfactor .

      Para obter mais informações sobre como criar o registro da aplicação, consulte Registre-se SuccessFactorsComo 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 é criado.

    Criar registro de conexão para a API OData

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credenciais.
    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 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 SuccessFactorsURL 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 SAP Help Portal 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 SuccessFactorscriado.

    Criar registro de conexão para a API SOAP

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credenciais.
    2. Aberto para o registro de API SOAP SuccessFactors .
      Por exemplo, SuccessFactors_Comp_Emp .
    3. Em Conexões clique em Novo .
      O sistema exibe um formulário 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 SAP Help Portal 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 SuccessFactorsinstância.
      Tempo limite de fluxo (segundos) Tempo máximo em segundos até o qual os dados podem ser recebidos SuccessFactorsdurante 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 SuccessFactorscriado.

    Sincronizar dados entre SuccessFactorse. ServiceNow

    Personalize os fluxos de amostra de acordo com seus requisitos para sincronizar dados entre seus SuccessFactorse. ServiceNow instâncias.

    Tarefa pendente

    . SuccessFactorso spoke fornece fluxos de amostra para sincronizar dados bidirecionalmente para a entidade todo. O fluxo de amostra Executar fluxo de integração SuccessFactors pode ser personalizado para recuperar dados do SuccessFactors, Enquanto os fluxos Criar tarefas pendentes e Atualizar tarefas pendentes criam ou atualizam os registros de tarefas pendentes em SuccessFactorsquando 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 do SuccessFactors:
    • Departamento
    • Local
    • Perfil do Trabalho
    • Perfil dos trabalhadores
    • Perfil de trabalhadores efetivos
    • Histórico de trabalhos, incluindo atribuições secundárias

    Para criar ou atualizar registros em SuccessFactorspara 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 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 SuccessFactorsentidades

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