Sdílet prostřednictvím

Použijte nástroj pro hromadné ověření Smlouvy se zákazníkem společnosti Microsoft.

Příslušné role: Agent pro správu | Prodejní agent

Platné mraky: Celosvětové

Nástroj pro hromadné ověření identity smlouvy se zákazníkem Microsoftu umožňuje partnerům potvrdit přijetí Smlouvy se zákazníkem Microsoftu jménem svých zákazníků. Tento nástroj je navržen tak, aby pomohl partnerům, kteří mají mnoho zákazníků a spadají do oblasti úsilí o obnovu zákaznické smlouvy Microsoftu.

Nástroj hromadného ověření identity má několik funkcí:

  • Opensourcový nástroj konzoly .NET pomocí opensourcové sady .NET SDK (7.0)
  • Podporuje formát souboru oddělený čárkami (.csv) pro nastavení hromadných ověření identity.
  • Nejsou vyžadovány žádné změny kódu a lze je využít pomocí příkazu .NET.
  • Kód je rozšiřitelný a dá se vylepšit, jak partneři uznají za vhodné.
  • Rozsáhlé protokolování vám může pomoct s řešením potíží.

Tento nástroj je určený pro partnery s přímým vyúčtováním a nepřímé poskytovatele, kteří provádí transakce prostřednictvím programu CSP.

Požadavky

  • Partnerské účty musí být povolené pro vícefaktorové ověřování (MFA), protože rozhraní API pracovního prostoru zákazníka vynucují vícefaktorové ověřování. MFA můžete přidat podle pokynů v Mandating MFA pro váš partnerský tenant.

  • Ujistěte se, že máte na hostitelském počítači nainstalovanou sadu .NET 7.0 SDK .

  • Konfigurace nativní aplikace v Partnerském centru:

    1. V Partnerském centru vyberte Nastavení (ikona ozubeného kola) >Nastavení účtu.

      Snímek obrazovky s nabídkou nastavení Partnerského centra se zvýrazněným nastavením účtu

    2. Vyberte stránku správy aplikací.

    3. Vyberte + Přidat novou nativní aplikaci. Vytvoří se pro vás nová aplikace. Zkopírujte ID aplikace a mějte ho po ruce.

      Snímek obrazovky se stránkou Správa aplikací se zvýrazněnou možností Přidat novou nativní aplikaci

      Nově vytvořenou aplikaci byste teď měli vidět na webu Azure Portal v části > ID Azure Entra.

      Snímek obrazovky se stránkou Registrace aplikací se zvýrazněnou nativní aplikací v Partnerském centru

    4. Na kartě Ověřování můžete přidat platformu pro mobilní a desktopové aplikace.

      Snímek obrazovky stránky Ověřování s otevřeným vyskakovacím panelem 'Konfigurovat platformy' a zvýrazněnými mobilními a stolními aplikacemi.

    5. Nakonfigurujte http://localhost a další identifikátory URI přesměrování pro aplikaci.

      Snímek obrazovky se stránkou 'Konfigurace plochy a zařízení', se zobrazenými identifikátory URI přesměrování.

    6. Po uložení ověřte, že jsou přesměrovací URI uvedeny na platformě mobilních a desktopových aplikací a že ID tokeny jsou vybrané v části Implicitní udělení a hybridní toky.

    Další informace najdete v tématu Ověřování v Partnerském centru.

Spusťte nástroj pro hromadnou atestaci Smlouva se zákazníkem společnosti Microsoft.

  1. Přejděte na ukázky DotNet v partnerském centru na GitHubu a vyberte možnost Kód>Stáhnout ZIP, abyste soubory extrahovali do místní složky. V extrahované složce je podsložka s názvem Microsoft Customer AgreementRefreshBulkAttestationCLITool. Teď jste připraveni nástroj spustit.

  2. Otevřete příkazový řádek a přejděte do složky, do které jste extrahovali soubory.

  3. Spusťte následující příkaz dotnet run: V případě potřeby počkejte, než se sestavení dokončí.

  4. Zadejte ID aplikace a hlavní název uživatele (UPN). Použijte ID nativní aplikace, které jste nastavili, a svůj hlavní název uživatele (UPN).

  5. Přihlaste se ke svému účtu pomocí vícefaktorového ověřování.

  6. Nástroj zobrazuje následující možnosti, které jsou popsány v následujících částech:

    Snímek obrazovky s možnostmi nástroje Hromadné ověření identity pro načtení nebo aktualizaci záznamů smlouvy se zákazníkem

Dokončení ověřování

Po spuštění nástroje se pokusí tiše načíst ověřovací token. Pokud selže, aktivuje se interaktivní režim a otevře se okno prohlížeče a požádá vás o přihlášení. Použijte stejné přihlašovací údaje, které používáte při přihlašování k Partnerskému centru.

Po úspěšném ověření se zobrazí následující zpráva. Zavřete okno prohlížeče a vraťte se do konzolové aplikace.

Snímek obrazovky s oknem localhost prohlížeče a zprávou, že je v pořádku zavřít kartu prohlížeče.

Vysvětlení podporovaných scénářů

Než nástroj použijete, poznamenejte si:

  • Tento nástroj není navržený tak, aby poskytoval podrobnosti o přímých podrobnostech o přijetí zákazníkem.
  • Nástroj má ověření vstupních dat na úrovni srovnatelné s Partner Center Create Agreement API.

Existují dva scénáře, které nástroj podporuje: načtení záznamů smlouvy se zákazníkem a aktualizace záznamů smlouvy se zákazníkem.

Načíst záznamy smluv se zákazníky

Tato operace používá rozhraní API Partnerského centra k načtení všech záznamů smlouvy se zákazníkem, které jsou v rozsahu Smlouva se zákazníkem Microsoftu Refresh pro vašeho partnerského tenanta. Nástroj pak záznamy uloží do souboru CSV (CustomerAgreementRecords.csv) do cesty podle vašeho výběru.

Pokud se aktualizovala smlouva se zákazníkem (buď prostřednictvím hromadného nástroje, portálu Partnerského centra nebo rozhraní API pro vytvoření smlouvy), záznam se nevrátí v operaci načtení a nezahrne se do souboru CSV. Všechny záznamy vrácené v souboru CSV jsou použitelné a musí být aktualizovány.

Příklad spuštění operace načtení:

Snímek obrazovky nástroje Hromadné ověření identity se zprávou, že načítá 14 záznamů smlouvy se zákazníkem z Partnerského centra

Část vrácených polí obsahuje kontaktní údaje zákazníka pro poslední smlouvu potvrzenou partnerem. Pokud existovalo předchozí ověření identity (smlouva potvrzená partnerem jménem zákazníka), zobrazí se v následujících polích kontaktní údaje zákazníka pro toto potvrzení. Jinak jsou prázdné. Tyto podrobnosti jsou k dispozici pro vaše usnadnění v případě, že přijímající agent je při aktualizaci přijetí stejný, ale jinak by měly být aktualizovány, aby přesně odrážely podrobnosti přijetí. Jakmile partner potvrdí přijetí smlouvy se zákazníkem Microsoftu, odešle se zákazníkovi e-mailové oznámení pomocí poskytnutého e-mailu.

Soubor CSV obsahuje následující pole:

  • ID Tenanta zákazníka: ID tenanta zákazníka / Microsoft ID
  • Kontaktní údaje zákazníka:
    • Jméno: Křestní jméno přijímajícího agenta v organizaci zákazníka u poslední smlouvy potvrzené partnerem.
    • Příjmení: Příjmení přijímajícího agenta v organizaci zákazníka podle poslední smlouvy potvrzené partnerem
    • E-mail: E-mailová adresa přijímajícího agenta v organizaci zákazníka poslední smlouvy potvrzené partnerem
    • Telefonní číslo: Telefonní číslo přijímajícího agenta v organizaci zákazníka ohledně poslední partnerem potvrzené smlouvy
    • LastAgreementDate: Datum a čas poslední smlouvy potvrzené partnerem
  • Ověření identity partnera dokončeno: Logická hodnota označující, jestli hromadný nástroj aktualizuje záznam smlouvy se zákazníkem. Toto pole je ve výchozím nastavení nastavené False a mělo by být nastavené na True všechny záznamy, které chcete aktualizovat.
  • Odkaz na účet zákazníka: Neoperační pole, které slouží k zobrazení přímého odkazu na stránku účtu zákazníka v Partnerském centru. Nástroj naplní toto pole, ale nepoužívá se pro žádné operace a neměl by být upraven.

Ukázkový soubor CSV:

Snímek obrazovky s ukázkovým výstupem ze souboru CSV

Návod

Před spuštěním první operace aktualizace doporučujeme uložit kopii záznamů zákaznických smluv na jiném místě pro vlastní záznamy. Jakmile se záznamy smlouvy se zákazníkem úspěšně aktualizují, považují se za vyřešené a v budoucnu se nevrátí.

Aktualizace záznamů smlouvy se zákazníkem

Tato operace používá rozhraní API Partnerského centra k aktualizaci záznamů smlouvy se zákazníkem ze souboru CSV vytvořeného operací načtení.

Než aktualizujete záznam smlouvy se zákazníkem, ujistěte se, že kontaktní údaje zákazníka pro přijímajícího agenta v organizaci zákazníka jsou přesné a up-to-date. Uděláte to tak, že v souboru CSV aktualizujete následující pole:

  • Jméno
  • Příjmení
  • E-mail
  • Telefonní číslo (volitelné)

Datum a čas smlouvy se automaticky vyplní v Partnerském centru.

Pokud chcete označit záznam smlouvy se zákazníkem k aktualizaci, nastavte pole Dokončeno partnerem na hodnotu True u záznamu v souboru CSV. Nástroj zpracovává pouze záznamy, které mají toto pole nastavené na Hodnotu True.

Příklad aktualizace souboru CSV pro prvních 2 zákazníků vrácených z operace načtení:

Snímek obrazovky s ukázkovým výstupem ze souboru CSV, kde Ověření partnera dokončeno je True

Po označení záznamů smlouvy se zákazníkem, které chcete aktualizovat, uložte a zavřete soubor CSV a spusťte operaci aktualizace z nabídky nástrojů. Nástroj vás vyzve k zadání cesty k souboru CSV. Po úspěšném parsování záznamů nástroj zobrazí počet nalezených záznamů, které se dají provést, a začne odesílat operace aktualizace.

U velkých objemů smluv může aktualizace nějakou dobu trvat, protože maximální počet smluv k aktualizaci na expedované volání je 500. Operace aktualizace probíhají asynchronně, jakmile se dostanou do Partnerského centra. Můžete očekávat zpoždění od doby, kdy nástroj dokončí operace aktualizace a kdy se záznamy smlouvy se zákazníkem aktualizují v Partnerském centru.

Příklad spuštění operace aktualizace:

Snímek obrazovky nástroje Hromadné ověření identity se zprávou o tom, že zpracoval dva záznamy s možností akce a dokončil operaci

Související obsah