Configurar o SuccessFactors spoke v4.xx

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 9 min. de leitura

    • Integre a instância ServiceNow à sua instância SuccessFactors usando a aplicação cliente OAuth e a chave de API.

    Antes de Iniciar

    • Solicite a assinatura do IntegrationHub.
    • Ativar 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 spoke v4.2.1 pela primeira vez. Se você estiver usando uma versão anterior do SuccessFactors spoke, consulte Migrar para SuccessFactors spoke v4.2.1 para obter 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.

    Registrar aplicação cliente OAuth no SuccessFactors

    Habilite a autenticação de certificado de cliente para a comunicação de saída do SAP Master Data Service gerando os arquivos keystore.jks e keystore.cer.

    Antes de Iniciar

    Procedimento

    1. Faça login na conta SuccessFactors como administrador.
    2. Navegue até Admin Center 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.
      No campo Certificado X.509, forneça o conteúdo do arquivo cert.pem (chave pública) sem os cabeçalhos.
    6. Clique em Enviar.
      A chave de API é gerada e exibida. Copie e registre o valor para uso posterior.

    Carregar o certificado JKS na sua instância ServiceNow

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Faça login na sua instância ServiceNow como administrador.
    2. Carregue o certificado JKS para sua instância ServiceNow.
      Para obter instruções para carregar o certificado JKS, consulte Carregar um certificado em uma instância .
      Carregar 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 OAuth.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em sua instância ServiceNow, navegue até OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
    3. No formulário, preencha esses 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 SAML2.
      URL do token SuccessFactors URL de 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 da aplicação.
    4. Clique em Enviar.

    Criar o registro do produtor de estipulação SAML2

    Crie um registro de asserção SAML2 para gerar a asserção 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 de produtor de asserção SAML2 na sua instância ServiceNow.
      1. Navegar até Todos > 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 SAML2. Por exemplo, Successfactor SAML OAuth.
        Emissor Identificador exclusivo da entidade de emissão da estipulação. Forneça o URL da instância ServiceNow.
        NameID do assunto Nome de usuário para fazer login na instância SuccessFactors. Por exemplo, sfadmin.
        Público Público-alvo da estipulação. Insira o valor, www.successfactors.com.
        Destinatário Destinatário pretendido para a estipulação. Insira a URL neste formato, https://<SuccessFactors-Instance-Name> /oauth/token .
        Registro do produtor de asserção SAML2.
      4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      5. Na guia Armazenamentos de chaves de estipulação do SAML2, clique em Novo.
      6. No formulário, preencha estes valores.
        Campo Descrição
        Nome Nome exclusivo para identificar o registro de armazenamento de chaves de asserção SAML2. Por exemplo, sap_successfactor.
        Alias das chaves de assinatura Alias da chave de entrada armazenada no armazenamento de chaves usado para assinar a estipulação. Por exemplo, 1.
        Senha da chave de assinatura Senha da chave de entrada armazenada no armazenamento de chaves usado para assinar a estipulaçã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 Carregar o certificado JKS na sua instância ServiceNow.
        Registro de armazenamento de chaves de asserção SAML2.
      7. Clique em Enviar.
      8. Navegar até Todos > OAuth de Sistema > Produtores de declaração de SAML2.
      9. Abra o registro do produtor de asserção SAML2 que você criou.
        Por exemplo, Successfactor SAML OAuth.
      10. Na guia 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 do atributo de asserção SAML2. Insira api_key.
        Tipo Tipo do campo Valor. 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 SAML2 ao registro da aplicação.
      1. Navegar até OAuth de Sistema > Registro de aplicações.
      2. Abra o registro da aplicação que você criou.
        Por exemplo, SuccessFactors OAuth Reg. Para obter mais informações sobre como criar o registro da aplicação, consulte Registrar SuccessFactors como um provedor OAuth.
      3. Na guia Perfis de entidade OAuth, abra o registro de perfil de entidade OAuth padrão.
        Por exemplo, Successfactor SAML default_profile.
      4. Para o campo Produtor de estipulação, selecione o registro do produtor de estipulação do SAML2 que você criou.
        Por exemplo, Successfactor SAML OAuth.
        Registro de perfil de entidade OAuth.
      5. Clique em Atualizar.

    Criar registro de credencial para a API do OData

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > 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 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 que está 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 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 é criado.

    Criar registro de credencial para SOAP API

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > 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 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 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 SOAP API é criado.

    Criar registro de conexão para a API do OData

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Aberto para o registro do SuccessFactors OData.
      Por exemplo, SuccessFactors_OData.
    3. Na guia 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 raiz do serviço neste formato: https://<SuccessFactors_Instance_Name> /odata/v2 . Por exemplo, https://example.successfactors.eu/odata/v2.
      Ativo Opção para usar ativamente o registro de conexão.
      Registro de conexão do OData.
    5. Clique em Enviar.

    Resultado

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

    Criar registro de conexão para a SOAP API

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

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Aberto para o registro da SOAP API do SuccessFactors.
      Por exemplo, SuccessFactors_Comp_Emp.
    3. Na guia 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 SOAP API. 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.
      Ativo Opção para usar ativamente o registro de conexão.
    5. Na guia Atributos, forneça esses campos.
      Campo Descrição
      ID da empresa ID imutável da empresa da sua instância SuccessFactors.
      Tempo Limite do Fluxo (segundos) Tempo máximo em segundos até o qual os dados podem ser recebidos de SuccessFactors durante a execução do fluxo. Se o tempo necessário para recuperar dados de 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 para a SOAP API em SuccessFactors foi criado.

    Sincronizar dados entre SuccessFactors e ServiceNow

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

    Entidade pendente

    O spoke SuccessFactors fornece fluxos de amostra para sincronizar dados bidirecionalmente para a entidade pendente. O fluxo de amostra, Executar fluxo de integração do SuccessFactors, pode ser personalizado para recuperar dados de SuccessFactors, enquanto os fluxos Criar tarefas e Atualizar tarefas criam ou atualizam os registros de tarefas em SuccessFactors quando os eventos ocorrem em ServiceNow. Ao personalizar os fluxos de amostra, certifique-se de fornecer 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 de SuccessFactors, pode ser personalizado para recuperar dados de 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 SuccessFactors para essas entidades quando os eventos ocorrerem em ServiceNow:

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

    Outras SuccessFactors entidades

    Dependendo das SuccessFactors permissões e configurações, você também pode sincronizar dados de outras entidades de acordo com seus requisitos.