Outil d’attestation en bloc du Contrat client Microsoft

Rôles appropriés : Agent d’administration | Commercial

Clouds applicables : Global

L’outil d’attestation en bloc du Contrat client Microsoft permet aux partenaires de confirmer l’acceptation du Contrat client Microsoft au nom de leurs clients. Cet outil est conçu pour aider les partenaires qui ont de nombreux clients et qui entrent dans l’étendue de l’effort d’actualisation du Contrat client Microsoft.

L’outil d’attestation en bloc a plusieurs fonctionnalités :

• Outil de console .NET open source à l’aide d’un Kit de développement logiciel (SDK) .NET open source (7.0)
• Prend en charge le format de fichier séparé par des virgules (.csv) pour la configuration des attestations en bloc
• Aucune modification du code n’est requise et peut être utilisée avec une commande .NET
• Le code est extensible et peut être amélioré en tant que partenaires jugent adapté
• La journalisation étendue peut vous aider à résoudre les problèmes

Cet outil est destiné aux partenaires de facturation directe et aux fournisseurs indirects qui effectuent des transactions via le programme CSP.

Prérequis

• Les comptes partenaires doivent être activés pour l’authentification multifacteur (MFA) en tant qu’API d’espace de travail client appliquant l’authentification multifacteur. Vous pouvez ajouter l’authentification multifacteur en suivant les instructions de l’authentification multifacteur pour votre locataire partenaire.

• Vérifiez que le Kit de développement logiciel (SDK) .NET 7.0 est installé sur l’ordinateur hôte.

• Configurez une application native dans l’Espace partenaires :

  1. Dans l’Espace partenaires, sélectionnez Paramètres (icône d’engrenage) >Paramètres du compte.

     

  2. Sélectionnez la page gestion des applications.

  3. Sélectionnez + Ajouter une nouvelle application native. Une nouvelle application est créée pour vous. Copiez l’ID d’application et conservez-le à portée de main.

     

     Vous devriez maintenant être en mesure de voir l’application nouvellement créée dans Portail Azure sous inscriptions d’applications d’ID > Azure Entra.

     

  4. Utilisez l’onglet Authentification pour ajouter une plateforme pour les applications mobiles et de bureau.

     

  5. Configurez les http://localhost URI de redirection et les autres URI de redirection pour l’application.

     

  6. Une fois enregistrés, vérifiez que les URI de redirection sont répertoriés sous la plateforme applications mobiles et de bureau, et que les jetons d’ID sont sélectionnés sous octroi implicite et flux hybrides.

  Pour en savoir plus, consultez l’authentification de l’Espace partenaires.

Exécuter l’outil d’attestation en bloc Contrat client Microsoft

1. Accédez aux exemples DotNet de l’Espace partenaires sur GitHub, puis sélectionnez Code Zip de téléchargement de code>postal pour extraire les fichiers dans un dossier local. Dans le dossier extrait, il s’agit d’un sous-dossier nommé Contrat client Microsoft RefreshBulkAttestationCLITool. Vous êtes maintenant prêt à exécuter l’outil.

2. Ouvrez l’invite de commandes et accédez au dossier où vous avez extrait les fichiers.

3. Exécutez la commande suivante : dotnet run. Si nécessaire, attendez que la build se termine.

4. Fournissez votre ID d’application et le nom d’utilisateur principal (UPN). Utilisez l’ID d’application natif que vous avez créé et votre UPN.

5. Connectez-vous à votre compte avec MFA.

6. L’outil présente les options suivantes, qui sont décrites dans les sections suivantes :

   

Authentification

Après avoir lancé l’outil, il tente d’extraire un jeton d’authentification en mode silencieux. En cas d’échec, un déclencheur en mode interactif et une fenêtre de navigateur s’ouvre pour vous demander de vous connecter. Utilisez les mêmes informations d’identification que celles que vous utilisez lors de la connexion à l’Espace partenaires.

Une fois l’authentification réussie, le message suivant s’affiche. Fermez la fenêtre du navigateur et revenez à l’application console.

Scénarios

Avant d’utiliser l’outil, notez :

• L’outil n’est pas conçu pour fournir des détails pour les détails d’acceptation directe du client
• L’outil a une validation des données d’entrée par parité avec l’API Créer un contrat espace partenaires

Il existe deux scénarios pris en charge par l’outil : extraire les enregistrements de contrat client et mettre à jour les enregistrements de contrat client.

Extraire les enregistrements de contrat client

Cette opération utilise l’API Espace partenaires pour extraire tous les enregistrements de contrat client qui sont dans l’étendue de l’actualisation Contrat client Microsoft pour votre locataire partenaire. L’outil enregistre ensuite les enregistrements dans un fichier CSV (CustomerAgreementRecords.csv) dans un chemin d’accès de votre choix.

Si un contrat client a été actualisé (via l’outil en bloc, le portail Espace partenaires ou l’API Créer un contrat), l’enregistrement ne sera pas retourné dans l’opération d’extraction. Il ne sera pas inclus dans le fichier CSV. Tous les enregistrements retournés dans le fichier CSV peuvent être actionnables et doivent être mis à jour.

Exemple d’exécution de l’opération d’extraction :

Une partie des champs retournés inclut les coordonnées du client pour le dernier contrat confirmé par le partenaire. Si une attestation précédente (contrat confirmé par le partenaire pour le compte du client) existait, les coordonnées du client pour cette confirmation sont affichées dans les champs suivants. Sinon, ils seront vides. Ces détails sont fournis pour votre commodité si l’agent accepté est le même au moment de l’actualisation de l’acceptation, mais sinon, il doit être mis à jour pour refléter avec précision les détails de l’acceptation. Une notification par e-mail sera envoyée au client à l’aide de l’e-mail fourni une fois que le partenaire confirme l’acceptation du Contrat client Microsoft.

Le fichier CSV contient les champs suivants :

• ID de locataire du client : ID client/Microsoft du client
• Détails du contact client :
  • FirstName : prénom de l’agent accepté dans l’organisation du client du dernier contrat confirmé par le partenaire
  • LastName : nom de l’agent accepté dans l’organisation du client du dernier contrat confirmé par le partenaire
  • E-mail : adresse e-mail de l’agent acceptant dans l’organisation du client du dernier contrat confirmé par le partenaire
  • Numéro de téléphone : numéro de téléphone de l’agent accepté dans l’organisation du client du dernier contrat confirmé par le partenaire
  • LastAgreementDate : Datetime du dernier contrat confirmé par le partenaire
• Attestation du partenaire terminée : valeur booléenne indiquant si l’enregistrement du contrat client doit être mis à jour par l’outil en bloc. Ce champ est défini False par défaut et doit être défini True sur pour tous les enregistrements que vous souhaitez mettre à jour.
• Lien de compte client : champ non opérationnel utilisé pour afficher un lien direct vers la page du compte du client dans l’Espace partenaires. L’outil remplit ce champ, mais n’est utilisé pour aucune opération et ne doit pas être modifié.

Exemple de fichier CSV :

Conseil

Avant de déclencher la première opération de mise à jour, il est recommandé d’enregistrer une copie des enregistrements du contrat client retournés à un autre emplacement pour vos propres enregistrements. Une fois les enregistrements de contrat client mis à jour avec succès, ils sont traités comme résolus et ne seront pas retournés à l’avenir.

Mettre à jour les enregistrements de contrat client

Cette opération utilise l’API Espace partenaires pour mettre à jour les enregistrements de contrat client à partir du fichier CSV créé par l’opération de récupération.

Avant de mettre à jour un enregistrement de contrat client, assurez-vous que les coordonnées du client pour l’agent acceptant dans l’organisation du client sont exactes et à jour. Pour ce faire, mettez à jour les champs suivants dans le fichier CSV :

• FirstName
• LastName
• E-mail
• PhoneNumber (facultatif)

La date d’heure du contrat est remplie automatiquement dans l’Espace partenaires.

Pour marquer un enregistrement de contrat client à mettre à jour, définissez le champ Attestation du partenaire sur True pour l’enregistrement dans le fichier CSV. L’outil traite uniquement les enregistrements dont ce champ a la valeur True.

Exemple de mise à jour du fichier CSV pour les 2 premiers clients retournés à partir de l’opération d’extraction :

Après avoir marqué les enregistrements du contrat client que vous souhaitez mettre à jour, enregistrez et fermez le fichier CSV, puis déclenchez l’opération de mise à jour à partir du menu outil. L’outil vous invite à fournir le chemin d’accès au fichier CSV. Une fois les enregistrements analysés, l’outil affiche le nombre d’enregistrements actionnables trouvés et commence à distribuer les opérations de mise à jour.

Pour de grandes quantités de contrats, les mises à jour peuvent prendre un certain temps, car le nombre maximal de contrats à mettre à jour par appel distribué est de 500. Les opérations de mise à jour se produisent de manière asynchrone une fois que vous atteignez l’Espace partenaires. Vous pouvez attendre un délai à partir du moment où l’outil termine les opérations de mise à jour et lorsque les enregistrements de contrat client sont mis à jour dans l’Espace partenaires.

Exemple d’exécution de l’opération de mise à jour :

Contenu connexe

• Faq sur l’outil d’attestation en bloc Contrat client Microsoft