Comment utiliser les activités Microsoft 365 sans connexion Integration Service

À propos

Vous pouvez désormais utiliser les nouvelles activités Microsoft 365 même si vous n'avez pas Integration Service, via les fonctionnalités Microsoft 365.

Les activités Microsoft 365 conçues spécifiquement pour Integration Service disposent d’un champ Connexion (Connection), qui permet de choisir une connexion créée via un connecteur Integration Service. Lorsqu’elles sont utilisées dans l’activité Microsoft 365 Scope, les activités héritent simplement des informations de connexion de l’étendue.

Authentification et matrice des types de projets

Microsoft 365
	Cloud		Version locale
	Étendue de l'application Microsoft Office 365	Integration Service	Étendue de l'application Microsoft Office 365	Integration Service
Multiplateforme
Jeton interactif - OAuth - Application publique UiPath
Jeton interactif - OAuth - BYOA
IntegratedWindowsAuthentication
UsernameAndPassword
ID d’application et Clé secrète
IDApplication et Certificat
Windows
Jeton interactif - OAuth - Application publique UiPath
Jeton interactif - OAuth - BYOA
IntegratedWindowsAuthentication
UsernameAndPassword
ID d’application et Clé secrète
IDApplication et Certificat

Méthodes de connexion

Il existe deux façons de configurer une connexion dans l’activité Étendue Microsoft 365 ( Microsoft 365 Scope ).

Méthode de connexion		Description	Bénéfices	Inconvénients
Ressource Remarque : Recommandé.		Utilise une ressource Orchestrator pour stocker la connexion avec la configuration de l'étendue. La ressource est au format JSON. Chaque fois qu'elle est utilisée, l'activité récupère la configuration de la ressource. En fonction de la configuration des ressources, l'activité Scope se comporte différemment ; il identifie le type d'authentification et masque les champs inutiles. Si la ressource JSON n’est pas correctement définie, une erreur de validation s’affiche.	Les activités bénéficient des recherches au moment de la conception et peuvent découvrir des fichiers, des dossiers, des listes, des plages et d'autres. La connexion est facilement transférable, car les informations d'identification ne sont pas transmises d'un utilisateur à un autre en texte brut. Peut être configuré par un administrateur. C'est plus sécurisé, car les informations d'identification n'atteignent pas le workflow Studio.	Nécessite qu'un utilisateur avancé configure la ressource. Pas facile à mettre en place par un Citizen Developer.
Panneau propriétés		Utiliser le panneau Propriétés (Properties) existant pour configurer les identifiants de connexion. La configuration peut être ajoutée en texte brut ou via des variables.	Plus facile à utiliser. Assure la rétrocompatibilité.
	Configuration en texte brut Remarque : Non recommandé.	Configurez le panneau Propriétés (Properties) avec des valeurs en texte brut.	Les activités bénéficient des recherches au moment de la conception et peuvent découvrir des fichiers, des dossiers, des listes, des plages et d'autres.	Moins sécurisé, car les informations d'identification doivent être transmises entre les utilisateurs en texte brut.
	Configuration via des variables	Configurez le panneau Propriétés avec des variables.	Plus sécurisé, car les informations d'identification n'atteignent pas le workflow Studio.	Les activités ne peuvent découvrir aucune ressource au moment de la conception.

Format de ressource Étendue Microsoft 365

Remarque : le uap utilisé dans les sections suivantes représente le nom d'utilisateur et le mot de passe.

Format de ressource standard

Voici le format JSON accepté que vous pouvez utiliser dans les ressources de texte, au moment de la conception ou au runtime, ou les deux, et les ressources d’identification que vous pouvez utiliser au moment de l’exécution pour spécifier les détails Microsoft 365 .

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "",
        "TenantId": ""
    }
}

Remarque : Lorsque vous utilisez les paramètres OAuth2AppData, ApplicationId et TenantId , assurez-vous de le remplir en fonction du mode d'authentification que vous avez choisi. Vous trouverez des exemples dans les sections qui suivent.

Voici la liste complète des options parmi lesquelles vous pouvez choisir pour les paramètres Environnement et Mode :

• "Environnement" : "Défaut" | « Global » | "Chine" | « allemand » | « USGovernment » | « USGovernmentDOD »
• "Mode": "interactif" | « intégré » | « uap » | "appidsecret" | "appidcertificate",

Configuration de la ressource de l’application UiPath multi-locataire (OAuth - UiPath public app)

Remarque : l'ID d'application dans l'exemple est l'ID d'application UiPath valide que vous pouvez utiliser pour les connexions.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": ""
    }
}

Lorsqu'un ID de locataire est requis, consultez la section Détails du jeton interactif .

Configuration de la ressource de l’application UiPath à locataire unique (OAuth - UiPath public app)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Configuration de la ressource d’application personnalisée à locataire unique (OAuth - BYOA)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "your unique Microsoft tenant ID",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Configuration de l’ID d’application et de l’application personnalisée du secret (OAuth - BYOA)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "your unique Microsoft 365 application secret",
    "Environment": "Default",
    "Mode": "appidsecret",
    "OAuth2AppData": {
        "ApplicationId": "your unique Microsoft tenant ID",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Limitations

Les fonctionnalités suivantes ne sont pas disponibles lors de l’utilisation d’activités à l’intérieur de Microsoft 365 Scope: déclencheurs, liaisons et expérience de remplacement.

Actualisation du jeton

Aucun service n'est disponible pour actualiser vos jetons de connexion, comme celui disponible dans Integration Service.

Si le jeton d’autorisation n’est pas actualisé pendant un certain nombre de jours, il expire et vous devez vous authentifier à nouveau. Pour éviter l’expiration des jetons d’autorisation, exécutez un robot avec cette connexion spécifique. L’exécution d’une automatisation avec l’activité Étendue (Scope) actualise le jeton d’autorisation.

Ressources OAuth 2.0 supplémentaires :

• Avec le flux d'approbation de l'administrateur : Flux d'informations d'identification du client OAuth 2.0 sur la plate-forme d'identités Microsoft
• Sans flux d'approbation d'administrateur : Plateforme d'identités Microsoft et flux de code d'autorisation OAuth 2.0 - Plateforme d'identités Microsoft