Passaggi principali
- Contattare l’IT per la creazione di una “App registration”.
- Installare le app.
- Completare il setup di DocFinance all’interno dell’app.
- Creare in BC all’interno della pagina “Applicazione Microsoft Entra” un record con i dati richiesti, generati al punto 1, e assegnarle i relativi permessi.
- Configurare la connessione su DocFinance.
L’autenticatione tramite utente è ancora disponibile, ma è suggerito l’utilizzo dell’autenticazione tramite applicazione Microsoft Entra.
Ma devo pubblicare dei web service?
No, l’app per comunicare con DocFinance utilizza delle page di tipo API, di conseguenza sono automaticamente esposte da BC, non è necessario creare il web service.
Installazione OnPrem
Credential Type: NavUserPassword
Enable API Services: true
Max Page Size: a scelta (default: 20'000)
Port: a scelta (default: 7048)
| Environment Name | Nome dell’environment |
| API publisher/group/version | Stringa che serve per comporre l’URL da chiamare (in caso di cambiamento in futuro, si può ottenere comodamente l’URL nuovo) |
| Company ID | ID della company su BC, lo si ottiene anche tramite lookup sulla lista delle company |
Configurare Oauth2 per i servizi OnPrem
È supportato l’uso di OData2.0 con servizi OnPrem.
Segui la guida Microsoft per preparare l’ambiente Business Central a lavorare con Entra ID visitando il seguente link:
Configura l’autenticazione di Microsoft Entra con OpenID Connect
Installazione SaaS
Per il SaaS la procedura è la seguente:
1. Sull’Azure portal cercare l’“App registrations” e selezionare “New registration”
2. Inserire il nome e premere “Register”
3. Andare nella pagina “Authentication”, cliccare su “Add a platform”, selezionare “Mobile and deskop applications”
4. Selezionare il primo redirect URL e cliccare su “configure”
5. Cambiare il valore del “Default client type” a Yes
6. Nella pagina “Certificates & secrets” creare una nuova client secret tramite l’apposita azione e salvare il valore. Successivamente non sarà più visibile, perciò è necessario esegure ora tale operazione;
7. Nella pagina “API Permission”, selezionare “Add a permission” e poi selezionare “Dynamics 365 Business Central”
8. Nella pagina successiva selezionare “Application permission” e selezionare “App_access”. Completare l’azione con “app_access”
9. Selezionare “Add a permission” e poi “Dynamics 365 Business Central”
10. Scegliere “Delegated permissions” e “user_impersonation” e cliccare su Add permissions
11. La pagina apparirà così:
Nella pagina di Overview si trova il client ID
In BC è possibile trovare altri campi di configurazione:
| Tenant ID | ID del tenant su cui si sta lavorando. |
| Environment Name | Nome dell’environment. |
| API publisher/group/version | Stringa che serve per comporre l’URL da chiamare (in caso di cambiamento in futuro, si può ottenere comodamente l’URL nuovo). |
| Company ID | ID della company su BC, è recuperabile anche con uno zoom sulla lista delle company. |
Prossimi passi
Terminati questi passaggi potete procedere al Setup della connessione verso BC in DocFinance
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.