Configurazione delle attività SuccessFactors con credenziali OAuth
Informazioni sulla configurazione delle attività SuccessFactors con credenziali OAuth
È possibile trasferire i dati dei dipendenti direttamente da SuccessFactors nella piattaforma Qualtrics attraverso l’utilizzo di attività di estrazione dei flussi di lavoro. Tuttavia, SuccessFactors richiede la configurazione di un client OAuth2 affinché Qualtrics recuperi i dati dal proprio sistema. Le azioni dei prerequisiti devono essere eseguite tramite il portale degli amministratori SuccessFactors per configurare le attività di estrazione Qualtrics per la prima volta.
Fase 1: creare un certificato X.509
Per generare un nuovo certificato, SuccessFactors consiglia di utilizzare OpenSSL con il seguente comando:
openssl req -node -x509 -sha256 -newkey rsa:2048 -keyout private.pem -out public.pem
Dopo aver eseguito questo programma, verranno generati due file di testo: public.pem e private.pem, che sono evidenziati sopra. Per visualizzare il contenuto di questi file, è possibile aprirli in qualsiasi editor di file di testo. In alternativa, utilizzare i comandi “ls” e “cat” nel terminale OpenSSL.
- public.pem: contiene la chiave pubblica del certificato X.509. Verrà utilizzato nella configurazione del client OAuth di Successfactors.
- private.pem: contiene la chiave privata del certificato X.509. Questo verrà utilizzato durante la configurazione delle attività del flusso di lavoro Qualtrics.
Passo 2: registrare un’applicazione client OAuth2
- Accedere al Centro amministrazione SuccessFactors. Annotare il Dominio API, l’ ID società e il Nome utente.
- Fare clic su Centro API.
- Fare clic su Configurazione OAuth per OData.
- Fare clic su Registra applicazione client.
- Incollare nello spazio fornito la chiave pubblica generata dal certificato X.509.
- Fare clic su Registra.
- Visualizzare l’applicazione client OAuth2 appena registrata.
- Copiare e salvare la chiave API. Questo verrà utilizzato nella terza fase.
Fase 3: Configurazione dell’account SuccessFactors nell’attività Qualtrics
Le fasi precedenti ti hanno fornito le informazioni necessarie per seguire le istruzioni del flusso di lavoro di estrazione dei dati Qualtrics:
- Nome: nome descrittivo della connessione.
- Nome utente: ID utente SAP.
- Chiave API: generata dall’applicazione OAuth2 registrata.
- Dominio Datacenter: dominio facente parte dell’URL Centro amministrazione SuccessFactors, mostrato nella prima fase di registrazione di un’applicazione OAuth2.
- Chiave privata certificato 509: valore della chiave privata generato dalla configurazione del certificato X.509. La chiave privata deve essere in formato PKCS8.
- ID società: ID società per istanza SuccessFactors, visualizzato nella prima fase di registrazione di un’applicazione OAuth2.
Aggiornamento delle credenziali SuccessFactors
Una volta aggiunta al flusso di lavoro, non è possibile modificare una connessione. Per aggiornare le impostazioni di connessione, è necessario creare un nuovo account e incorporare le modifiche necessarie. Aprire l’attività dei flussi di lavoro e fare clic su Aggiungi un account utente.
Se non si utilizza più la connessione precedente, è possibile eliminarla facendo clic sui tre punti a destra e selezionando Rimuovi account.
Risoluzione dei problemi relativi agli errori di autenticazione
Se le impostazioni di connessione OAuth non sono configurate correttamente, verrà visualizzato un messaggio di errore quando si tenta di salvare le credenziali. Per risolvere questi problemi, riconfigurare l’attività con le credenziali corrette seguendo la procedura descritta sopra.
Codice errore | Messaggio di errore | Spiegazione |
SFSF_2 | Non è consentito accedere alle API su questo server utilizzando l’autenticazione standard o OAuth. Utilizzare invece il server API. | L’URL del server fornito nella configurazione della connessione non è supportato con le connessioni OAuth e deve essere aggiornato. Le nuove credenziali dovranno essere configurate utilizzando un server da questo elenco.
Se il dominio non è presente in questo elenco, contattare il supporto SuccessFactors. |
SFSF_3 | Il dominio “{Domain}” associato alle credenziali del task non è un dominio SuccessFactors valido | Il campo dominio della configurazione delle credenziali non è valido. Sarà necessario configurare nuove credenziali. |
SFSF_5 | Credenziali non trovate | Impossibile trovare le credenziali associate alla configurazione. È necessario configurare nuove credenziali. |
SFSF_6 | Campi con credenziali mancanti | Le credenziali non sono configurate correttamente. Per risolvere il problema, creare una nuova configurazione seguendo la procedura descritta sopra. |
SFSF_7 | Schema di autorizzazione non supportato | Indica l’utilizzo delle credenziali dello schema di autorizzazione di base. Le credenziali di autenticazione di base sono obsolete e non funzioneranno più. Per risolvere il problema, creare nuove credenziali seguendo la procedura descritta sopra. |
SFSF_8 | La chiave privata deve essere in formato PKCS8 | La chiave privata del certificato X.509 fornita non è nel formato PKCS8 richiesto. La chiave privata deve avere il formato:
Se la chiave non ha questo formato, copiare e incollare il comando OpenSSL:
|
SFSF_8 | Codice di risposta imprevisto dalla richiesta all’URL: https://successfactors.com/oauth/token, stato risposta:401, errore: impossibile autenticare il client (accesso non riuscito – utente non valido)
OPPURE codice di risposta imprevisto dalla richiesta all’URL: https://successfactors.com/oauth/token, stato risposta:401, errore: impossibile mappare “{ID utente” a un ID utente BizX valido |
Il nome utente fornito nella configurazione della connessione non è un ID utente SAP valido nell’istanza SuccessFactors dell’azienda. In SAP, i nomi utente possono essere diversi da ID utente e ID persona, anche se spesso coincidono. |
SFSF_8 | Credenziali
client non valide OPPURE impossibile convalidare “api_key” nell’asserzione SAML |
La chiave API fornita nella configurazione della connessione non è corretta. |
Risoluzione dei problemi relativi agli errori di non autenticazione
Se l’esecuzione del flusso di lavoro mostra un errore diverso, potrebbe indicare un errore di configurazione non correlato a OAuth.
Codice errore | Messaggio di errore | Spiegazione |
SFSF_1 | I messaggi di errore possono variare in base al contesto del problema | Si è verificato un errore imprevisto. Contatta il supporto Qualtrics. |
SFSF_2 | Risposta imprevista da SuccessFactors. Controlla la configurazione e riprova | È stato ricevuto un errore non riconosciuto da SuccessFactors. Ciò indica un problema di configurazione, quindi controlla la tua configurazione e contatta il supporto Qualtrics se l’errore persiste. |
SFSF_2 | Proprietà “{PropertyName}” non accessibili | “{PropertyName}” in SuccessFactors non è disponibile tramite l’API OData SuccessFactors. Per risolvere il problema, rimuovere la proprietà dalla configurazione e riprovare. |
SFSF_2 | Nomi proprietà non validi: “{PropertyName}” | “{PropertyName}” non esiste nell’istanza SuccessFactors. Rimuovere la proprietà dalla configurazione e riprovare. |