Configure o. SuccessFactors spokev4.x.x

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 9 min. de leitura

    • Integre o. ServiceNowinstância com seu SuccessFactorsInstância que usa a aplicação cliente OAuth e a chave de API.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • 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 é aplicável se você estiver configurando o. SuccessFactors spokev 4.5.0 pela primeira vez. Se você estiver usando uma versão anterior do SuccessFactors spoke, consulte Migrar para SuccessFactors spokev 4.5.0para o procedimento de migração.

    Para obter mais informações sobre como configurar o spoke, consulte 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 de SAPServiço de dados mestres gerando keystore.jks e. armazenamento de chaves arquivos .cer.

    Antes de Iniciar

    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 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 ServiceNowinstância

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

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

    Registrar SuccessFactorsComo um provedor de 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 ServiceNowinstância, navegue até OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
    3. No formulário, preencha estes campos.
      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.
      Tipo de concessão padrão Tipo de concessão padrão usado para estabelecer o token. Selecione Portador do SAML2 .
      URL de Token SuccessFactorsURL 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 de 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 ServiceNowinstâ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 asserção do SAML2. Por exemplo, OAuth SAML do fator de sucesso .
        Emissor Identificador exclusivo da entidade emissora de asserção. Forneça o. ServiceNowURL da instância.
        NameID do assunto Nome de usuário para fazer login no SuccessFactorsinstâ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 ServiceNowinstância.
        Registro do armazenamento de chaves de asserçã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 asserção do SAML2 que você criou.
        Por exemplo, OAuth 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, Reg. De OAutors SuccessFactors . Para obter mais informações sobre como criar o registro da aplicação, consulte Registrar SuccessFactorsComo um provedor de OAuth.
      3. Em Perfis de entidade OAuth Abra o registro de perfil de entidade OAuth padrão.
        Por exemplo, Successfactor SAML default_profile .
      4. Para Produtor de asserção Selecione o registro do produtor de asserção do SAML2 que você criou.
        Por exemplo, OAuth 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 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 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, Successfactor SAML default_profile .

      Para obter mais informações sobre como criar o registro da aplicação, consulte Registrar SuccessFactorsComo um provedor de 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 foi criado.

    Crie 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 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, Successfactor SAML default_profile .

      Para obter mais informações sobre como criar o registro da aplicação, consulte Registrar SuccessFactorsComo um provedor de 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 spokeo 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 SuccessFactorsURL 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 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 SuccessFactorsfoi criado.

    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 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 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 SuccessFactorsfoi criado.

    Sincronizar dados entre SuccessFactorse. ServiceNow

    Personalize os fluxos de amostra de acordo com seu requisito para sincronizar dados entre o. SuccessFactorse. ServiceNowinstâncias.

    Entidade pendente

    . SuccessFactorso 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 pendentes criam ou atualizam os registros 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 de SuccessFactors:
    • Departamento
    • Local
    • Perfil do Trabalho
    • Perfil do trabalhador
    • 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 as 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 de SuccessFactorse configurações, você também pode sincronizar dados de outras entidades de acordo com sua necessidade.