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
ID d’application et Certificat
ID et clé secrète de l’application
OAuth – BYOA
OAuth – application UiPath
Nom d’utilisateur et mot de passe
IntegratedWindowsAuthentication
Windows
ID d’application et Certificat
ID et clé secrète de l’application
OAuth – BYOA
OAuth – application UiPath
Nom d’utilisateur et mot de passe
IntegratedWindowsAuthentication

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

Format de ressource standard

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default" | "Global" | "China" | "Germany" | "USGovernment" | "USGovernmentDOD",
    "Mode": "interactive" | "integrated" | "uap" | "appidsecret" | "appidcertificate",
    "OAuth2AppData": {
        "ApplicationId": "",
        "TenantId": ""
    }
}

Configuration de la ressource d’application UiPath

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

Configuration personnalisée des ressources d'application

Remarque : il ne s'agit que d'un exemple. Configurez votre propre application et récupérez les données OAuth2AppData requises.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive" | "integrated" | "uap" | "appidsecret" | "appidcertificate",
    "OAuth2AppData": {
        "ApplicationId": "d47f7253-65ae-58n5-ag04-26109734e6de",
        "TenantId": "3ce4ef03-chb1-871f-94b0-345136965f10"
    }
}

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