Moduli Microsoft SharePoint Online

Espandi per visualizzare i requisiti di accesso per la funzionalità descritta in questo articolo.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront	Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront. Workfront Ultimate Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion.
Licenze Adobe Workfront	Standard Work o successiva
Licenza di Adobe Workfront Fusion	Basato su operazioni: disponibile per le organizzazioni con licenze basate su operazioni Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration
Prodotto	Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.

Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.

Espandere per visualizzare le istruzioni per la connessione di Microsoft SharePoint Online a Workfront Fusion tramite un account Microsoft.

È possibile utilizzare l’account Microsoft per creare una connessione a Microsoft SharePoint Online. Per istruzioni sulla connessione dell’account Sharepoint a Workfront Fusion, vedere Creare una connessione ad Adobe Workfront Fusion - Istruzioni di base.

Espandere per visualizzare le istruzioni per la connessione di Microsoft SharePoint Online a Workfront Fusion utilizzando le impostazioni avanzate.

Per includere le credenziali nella connessione, abilita l’opzione Mostra impostazioni avanzate. Per questo tipo di connessione sono necessari un ID client, un segreto client e un ID tenant.

1. In qualsiasi modulo di SharePoint, fai clic su Aggiungi accanto al campo Connessione per aprire la casella Crea una connessione.

2. Fare clic su Mostra impostazioni avanzate.

3. Compila i seguenti campi:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Connection type (Tipo di connessione)	Per utilizzare le credenziali client, selezionare E-mail Microsoft 365.
   Connection name (Nome della connessione)	Specifica un nome per la connessione.
   ID client	Immetti l'ID client per l'app SharePoint a cui ti stai connettendo.
   Segreto client	Immetti il segreto client per l’app SharePoint a cui ti stai connettendo.
   ID tenant	Immetti l’ID tenant dell’app SharePoint a cui ti stai connettendo.

4. Fai clic su Continua per salvare la connessione e tornare al modulo.

Espandere per visualizzare le istruzioni per la connessione di Microsoft SharePoint Online a Workfront Fusion tramite l'autorizzazione del certificato.

Puoi utilizzare l’autorizzazione del certificato per connetterti a SharePoint.

note important
IMPORTANT
Per utilizzare l’autorizzazione del certificato, devi innanzitutto creare un’app in Microsoft Entra e caricare il certificato da tale app.
Per istruzioni, vedere Come configurare le autorità di certificazione per l'autenticazione basata su certificato Microsoft Entra nella documentazione di Microsoft.

1. In qualsiasi modulo di SharePoint, fai clic su Aggiungi accanto al campo Connessione per aprire la casella Crea una connessione.

2. Fare clic su Mostra impostazioni avanzate.

3. Compila i seguenti campi:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Connection type (Tipo di connessione)	Per utilizzare l'autorizzazione del certificato, selezionare Microsoft SharePoint Online (Autenticazione certificato).
   Connection name (Nome della connessione)	Specifica un nome per la connessione.
   ID client	Immetti l'ID client per l'app SharePoint a cui ti stai connettendo.
   Thumbprint	Immetti l’identificazione personale dell’app SharePoint a cui ti stai connettendo.
   Chiave privata	Immetti il certificato o la chiave privata generati al momento della creazione delle credenziali in Microsoft. Per estrarre la chiave privata o il certificato: Fai clic su Estrai. Seleziona se stai estraendo un certificato o una chiave privata. Seleziona il tipo di file da estrarre. Seleziona il file che contiene la chiave privata o il certificato. Inserisci la password per il file. Fai clic su Salva per estrarre il file e tornare alla configurazione della connessione.

4. Fai clic su Continue (Continua) per salvare la connessione e tornare al modulo.

Espandere per visualizzare le istruzioni per la connessione di Microsoft SharePoint Online a Workfront Fusion utilizzando un'entità servizio.

È possibile creare una connessione che utilizza un’entità servizio (una connessione API dell’applicazione) invece di un account personale. Ciò è utile quando si desidera che la connessione venga eseguita come identità di un’applicazione o di un servizio anziché come persona specifica, ad esempio, in modo che l’integrazione non si interrompa se la persona lascia l’azienda o modifica la password.

note important
IMPORTANT
Questo tipo di connessione è disponibile solo per il modulo Effettua una chiamata API. Altri moduli SharePoint richiedono uno degli altri tipi di connessione descritti in questo articolo.

• Prerequisiti per la connessione di Microsoft SharePoint Online a Workfront Fusion tramite un’entità servizio
• Creare la registrazione dell’app in Microsoft Entra ID
• Creare un segreto client
• Concedere le autorizzazioni API
• Raccogliere i dettagli di connessione
• Creare la connessione

Prerequisiti per la connessione di Microsoft SharePoint Online a Workfront Fusion tramite un’entità servizio

Per registrare l’app e concederle le autorizzazioni, è necessario l’accesso Amministratore globale, Amministratore applicazioni o Amministratore ruoli con privilegi in Microsoft Entra ID. Se non disponi di questo accesso, chiedi a qualcuno del tuo team IT o di identità di completare questi passaggi al posto tuo.

Continua con Crea la registrazione all’app in Microsoft Entra ID.

Creare la registrazione dell’app in Microsoft Entra ID (entità servizio)

1. Accedere al centro di amministrazione Microsoft Entra.
2. Vai a Registrazioni app > Nuova registrazione.
3. Assegna all’app un nome chiaro e riconoscibile. Ad esempio, Make - SharePoint Integration.
4. Lascia vuoto URI reindirizzamento. Questa connessione non richiede l’accesso tramite un browser.
5. Seleziona Registra.
6. Continua con Crea un segreto client.

Creare un segreto client (entità servizio)

1. Nella tua nuova registrazione all’app, vai a Certificati e segreti.
2. Seleziona Nuovo segreto client, aggiungi una descrizione e scegli un periodo di scadenza.
3. Seleziona Aggiungi.
4. Copia immediatamente il Valore del segreto. Viene visualizzato una sola volta. Se esci prima di copiarlo, devi crearne uno nuovo.
5. Continua con Concedi autorizzazioni API.

Concedere le autorizzazioni API (entità servizio)

1. Nella registrazione dell’app, vai a Autorizzazioni API.
2. Seleziona Aggiungi un’autorizzazione, quindi seleziona Microsoft Graph.
3. Selezionare Autorizzazioni applicazione.
4. Seleziona l’autorizzazione o le autorizzazioni necessarie per le chiamate API, quindi seleziona Aggiungi autorizzazioni.
5. Seleziona Concedi il consenso all’amministratore per la tua organizzazione, quindi conferma.
6. Continua con Raccogliere i dettagli della connessione.

Raccogliere i dettagli di connessione (entità servizio)

Nella pagina Panoramica della registrazione dell’app, prendi nota dei seguenti valori. Immetti questi valori durante la creazione della connessione nel modulo.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
ID tenant	Nella pagina Panoramica, con etichetta ID directory (tenant).
ID client	Nella pagina Panoramica, etichettato ID applicazione (client).
Client Secret (Segreto client)	Il valore copiato in Crea un segreto client.

Continua a Creare la connessione.

Creare la connessione (entità servizio)

1. Nel modulo Effettua una chiamata API, fai clic su Aggiungi accanto al campo Connessione per aprire la casella Crea una connessione.

2. Fare clic su Mostra impostazioni avanzate.

3. Nel campo Tipo di connessione, selezionare Entità servizio.

4. Immetti il codice seguente:

   • ID tenant
   • ID client
   • Segreto client

5. Fai clic su Continua per salvare la connessione e tornare al modulo.

   Se tutto è configurato correttamente, la connessione viene convalidata correttamente.

Espandere per visualizzare le istruzioni per la connessione di Microsoft SharePoint Online ad Adobe Workfront Fusion mediante una connessione federata.

Una connessione federata funziona come la connessione dell’entità servizio, con la differenza che non utilizza un segreto client.
Invece di memorizzare un segreto, si consiglia a Microsoft Entra ID di considerare attendibili i token che Workfront Fusion ha problemi per una connessione specifica. Quando la connessione viene eseguita, Fusion presenta una prova di identità di breve durata e Microsoft Entra ID restituisce un token di accesso. Poiché non esiste alcun segreto client, non esiste nulla che scada e nessun segreto da ruotare o archiviare.

note
NOTE
Questa connessione richiede due visite al centro di amministrazione di Microsoft Entra. Registra prima l’app, quindi crea la connessione in Workfront Fusion, quindi torna a Microsoft Entra ID per aggiungere le credenziali federate. Questo perché le credenziali federate identificano una connessione specifica e tale identificatore non esiste finché non viene creata la connessione.

• Prerequisiti per la connessione di Microsoft SharePoint Online a Workfront Fusion tramite una connessione federata
• Creare la registrazione dell’app in Microsoft Entra ID (connessione federata)
• Concedere le autorizzazioni API (connessione federata)
• Raccogliere i dettagli di connessione (connessione federata)
• Creare la connessione in Workfront Fusion (connessione federata)
• Aggiungere le credenziali federate in Microsoft Entra ID (connessione federata)
• Verifica la connessione (connessione federata)
• Risoluzione dei problemi

Prerequisiti per la connessione di Microsoft SharePoint Online a Workfront Fusion tramite una connessione federata

Per registrare l’app, concederle le autorizzazioni e aggiungere le credenziali federate è necessario disporre dell’accesso Amministratore globale, Amministratore applicazione o Amministratore ruoli con privilegi in Microsoft Entra ID. Se non disponi di questo accesso, chiedi a qualcuno del tuo team IT o di identità di completare questi passaggi al posto tuo.

Creare la registrazione dell’app in Microsoft Entra ID (connessione federata)

1. Accedi al centro di amministrazione di Microsoft Entra.
2. Vai a Registrazioni app > Nuova registrazione.
3. Assegna all’app un nome chiaro e riconoscibile. Ad esempio, Workfront Fusion SharePoint Integration.
4. Lascia vuoto URI di reindirizzamento. Questa connessione non richiede l’accesso tramite un browser.
5. Seleziona Registra.
   Non creare un segreto client. Una connessione federata non ne utilizza una.
6. Continua a concedere le autorizzazioni API.

Concedere le autorizzazioni API (connessione federata)

1. Nella registrazione dell’app, vai a Autorizzazioni API.
2. Seleziona Aggiungi un’autorizzazione, quindi seleziona Microsoft Graph.
3. Selezionare Autorizzazioni applicazione.
4. Seleziona l’autorizzazione o le autorizzazioni necessarie per le chiamate API, quindi seleziona Aggiungi autorizzazioni.
5. Seleziona Concedi il consenso amministratore per la tua organizzazione, quindi conferma.
6. Continua con Raccogliere i dettagli della connessione.

Raccogliere i dettagli di connessione (connessione federata)

1. Nella pagina Panoramica della registrazione dell’app, prendi nota dei seguenti valori. Immetti questi valori durante la creazione della connessione nel modulo.

   table 0-row-2 1-row-2 layout-auto html-authored no-header
   ID tenant	Nella pagina Panoramica, con etichetta ID directory (tenant).
   ID client	Nella pagina Panoramica, etichettato ID applicazione (client).

2. Continua con Crea la connessione in Workfront Fusion.

Creare la connessione in Workfront Fusion (connessione federata)

1. Nel modulo Effettua una chiamata API, fai clic su b accanto al campo Connessione per aprire la casella Crea una connessione.

2. Fai clic su (Connessione federata).

3. Nel campo Tipo di connessione selezionare il tipo di connessione federata.

4. Immetti il codice seguente:

   • ID tenant
   • ID client

5. Seleziona Crea.
   In Workfront Fusion vengono visualizzati tre valori. Utilizzale nella procedura successiva.

   table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
   Emittente	Sempre https://oidc.automations.adobe.com.
   Subject	Identifica questa connessione. È fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964. È diversa per ogni connessione creata.
   Audience	Sempre api://AzureADTokenExchange.

6. Lascia aperto questo pannello e copia il valore Subject.

   note
   NOTE
   Non chiudere il pannello e non selezionare Annulla. La connessione non viene completata fino a quando non vengono completate le procedure rimanenti. Se chiudi il pannello, devi eliminare la connessione e riavviarla, perché a una nuova connessione viene assegnato un nuovo Oggetto.

7. Continuare con Aggiungere le credenziali federate nell’ID Entra di Microsoft.

Aggiungere le credenziali federate in Microsoft Entra ID (connessione federata)

Questa procedura sostituisce il segreto client. Indica a Microsoft Entra ID di accettare i token che Workfront Fusion genera per questa connessione.

1. In una nuova scheda del browser, torna al centro di amministrazione di Microsoft Entra e apri la registrazione all’app.

2. Vai a Certificati e segreti > Credenziali federate.

3. Selezionare Aggiungi credenziali.

4. Nello scenario con credenziali federate, selezionare Altro emittente.

5. Immetti il codice seguente:

   table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
   Emittente	https://oidc.automations.adobe.com.
   Subject identifier	Oggetto copiato da Workfront Fusion. Incollalo esattamente, senza spazi aggiunti.
   Nome	Un nome che identifica la connessione, in modo da poterla trovare in un secondo momento. Ad esempio, workfront-fusion-connection-28964.
   Audience	api://AzureADTokenExchange. Questo di solito è compilato per te. Lascia il valore predefinito.

6. Seleziona Aggiungi.

7. Continua con Verifica la connessione.

Verifica la connessione (connessione federata)

1. Tornare alla scheda del browser Workfront Fusion, dove il pannello di connessione è ancora aperto.

2. Seleziona Salva.

   • Se tutto è configurato correttamente, la connessione viene convalidata correttamente e puoi procedere con la configurazione del modulo.
   • Se la verifica non riesce, il pannello rimane aperto e visualizza l’errore. Risolvere il problema in Microsoft Entra ID e selezionare Salva di nuovo. Non è necessario ricreare la connessione e l’oggetto non cambia.

Risoluzione dei problemi

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Impossibile verificare la connessione a causa di un client non valido o di un errore di richiesta non valido	L’ID dell’endpoint Microsoft non può corrispondere al token per una credenziale federata. Verificare che l'autorità emittente sia esattamente https://oidc.automations.adobe.com senza barra finale e che l'identificatore dell'oggetto sia identico al carattere indicato in Workfront Fusion. La causa più comune è un oggetto copiato da una connessione diversa.
La connessione viene verificata, ma le chiamate API restituiscono 403	L’identità è attendibile, ma l’app non dispone delle autorizzazioni Microsoft Graph necessarie per la chiamata. Torna a Concedere le autorizzazioni API, aggiungere l’autorizzazione dell’applicazione richiesta e concedere il consenso all’amministratore.
Impossibile aggiungere un'altra credenziale federata	Hai raggiunto il limite di 20 credenziali federate per la registrazione dell’app. Registra un’app aggiuntiva e crea ulteriori connessioni.