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 l’activité Microsoft 365 Scope.

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 manières de configurer une connexion dans l’activité Microsoft 365 Scope .

Méthode de connexion		Description	Bénéfices	Inconvénients
Ressource (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 via texte brut (non recommandée)	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 :

• "Environment": "Default" | "Global" | "China" | "Germany" | "USGovernment" | "USGovernmentDOD",
• "Mode": "interactive" | "integrated" | "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 dans 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é Microsoft
• Sans flux d’approbation de l’administrateur : plate-forme d’identité Microsoft et flux de code d’autorisation OAuth 2.0 - Plate-forme d’identité Microsoft