API e personalizzazione per Collaborazione B2B di Azure Active DirectoryAzure Active Directory B2B collaboration API and customization

Molti clienti hanno manifestato il desiderio di poter personalizzare il processo di invito in modo più adatto alla propria organizzazione.We've had many customers tell us that they want to customize the invitation process in a way that works best for their organizations. Con l'API, è possibile farlo.With our API, you can do just that. https://developer.microsoft.com/graph/docs/api-reference/v1.0/resources/invitationhttps://developer.microsoft.com/graph/docs/api-reference/v1.0/resources/invitation

Funzionalità dell'API di invitoCapabilities of the invitation API

L'API offre le funzionalità seguenti:The API offers the following capabilities:

  1. Invitare un utente esterno con qualsiasi indirizzo di posta elettronica.Invite an external user with any email address.

    "invitedUserDisplayName": "Sam"
    "invitedUserEmailAddress": "gsamoogle@gmail.com"
    
  2. Personalizzare la pagina di destinazione visualizzata dagli utenti dopo avere accettato l'invito.Customize where you want your users to land after they accept their invitation.

    "inviteRedirectUrl": "https://myapps.microsoft.com/"
    
  3. Scegliere di inviare il messaggio di invito standard tramite MicrosoftChoose to send the standard invitation mail through us

    "sendInvitationMessage": true
    

    con un messaggio personalizzabile per il destinatariowith a message to the recipient that you can customize

    "customizedMessageBody": "Hello Sam, let's collaborate!"
    
  4. Scegliere di mettere in copia conoscenza le persone che si vuole mantenere nel ciclo relativo all'invito di questo collaboratore.And choose to cc: people you want to keep in the loop about your inviting this collaborator.

  5. Personalizzare completamente l'invito e il flusso di lavoro di onboarding scegliendo di non inviare notifiche tramite Azure AD.Or completely customize your invitation and onboarding workflow by choosing not to send notifications through Azure AD.

    "sendInvitationMessage": false
    

    In questo caso, si ottiene un URL di riscatto dall'API, che è possibile incorporare in un modello di messaggio di posta elettronica, in un messaggio istantaneo o in un altro metodo di distribuzione.In this case, you get back a redemption URL from the API that you can embed in an email template, IM, or other distribution method of your choice.

  6. Gli amministratori infine possono scegliere di invitare l'utente come membro.Finally, if you are an admin, you can choose to invite the user as member.

    "invitedUserType": "Member"
    

Modello di autorizzazioneAuthorization model

L'API può essere eseguita nelle modalità di autorizzazione seguenti:The API can be run in the following authorization modes:

Modalità app + utenteApp + User mode

In questa modalità, chiunque usi l'API deve disporre delle autorizzazioni per creare gli inviti B2B.In this mode, whoever is using the API needs to have the permissions to be create B2B invitations.

Modalità solo appApp only mode

In un contesto solo app, per garantire l'esito positivo dell'invio è necessario che l'app disponga dell'ambito User.ReadWrite.All o Directory.ReadWrite.All.In app only context, the app needs the User.ReadWrite.All or Directory.ReadWrite.All scopes for the invitation to succeed.

Per altre informazioni, vedere https://graph.microsoft.io/docs/authorization/permission_scopesFor more information, refer to: https://graph.microsoft.io/docs/authorization/permission_scopes

PowerShellPowerShell

Ora è possibile usare PowerShell per aggiungere e invitare facilmente utenti esterni a un'organizzazione.It is now possible to use PowerShell to add and invite external users to an organization easily. Creare un invito tramite il cmdlet:Create an invitation using the cmdlet:

New-AzureADMSInvitation

È possibile usare le opzioni seguenti:You can use the following options:

  • -InvitedUserDisplayName-InvitedUserDisplayName
  • -InvitedUserEmailAddress-InvitedUserEmailAddress
  • -SendInvitationMessage-SendInvitationMessage
  • -InvitedUserMessageInfo-InvitedUserMessageInfo

È anche possibile controllare il riferimento all'API di invito in https://developer.microsoft.com/graph/docs/api-reference/v1.0/resources/invitationYou can also check out the invitation API reference in https://developer.microsoft.com/graph/docs/api-reference/v1.0/resources/invitation

Passaggi successiviNext steps

Vedere gli altri articoli su Azure AD B2B Collaboration.Browse our other articles on Azure AD B2B collaboration: