Fügen Sie eine überprüfte Do Standard zur Liste der genehmigten Aufgaben hinzu Standard s für einen vorhandenen Kunden

Artikel
10/18/2023

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

Hinzufügen einer überprüften Do Standard zur Liste der genehmigten Aufgaben Standard für einen vorhandenen Kunden.

Voraussetzungen

Sie müssen ein Partner sein, der eine Do Standard Registrierungsstelle ist.
Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).

Hinzufügen einer überprüften Do Standard

Wenn Sie ein Partner sind, der eine Do Standard registrierungsstelle ist, können Sie die verifieddomain API verwenden, um eine neue Do Standard-Ressource in die Liste der do Standard s für einen vorhandenen Kunden zu posten. Identifizieren Sie dazu den Kunden mithilfe ihrer CustomerTenantId. Geben Sie einen Wert für die VerifiedDo Standard Name-Eigenschaft an. Übergeben Sie eine Do Standard-Ressource in der Anforderung mit den erforderlichen Eigenschaften "Name", "Capability", "AuthenticationType", "Status" und "VerificationMethod". Um anzugeben, dass die neue Do Standard eine Sammelfunktion ist Standard legen Sie die AuthenticationType-Eigenschaft in der Do Standard-Ressource auf Federated, und fügen Sie eine Do Standard Federation Einstellungen Ressource in die Anforderung ein. Wenn die Methode erfolgreich ist, enthält die Antwort eine Do Standard-Ressource für die neue überprüfte Do Standard.

Benutzerdefinierte überprüfte Aufgaben Standard

Wenn Sie eine benutzerdefinierte überprüfte Do Standard hinzufügen Standard die nicht für onmicrosoft.com registriert ist, müssen Sie die Eigenschaft CustomerUser.immutableId auf einen eindeutigen ID-Wert für den Kunden festlegen, für den Sie die Do hinzufügen Standard. Dieser eindeutige Bezeichner ist während des Überprüfungsprozesses erforderlich, wenn dies der Fall ist Standard überprüft wird. Weitere Informationen zu Kundenbenutzerkonten finden Sie unter Erstellen von Benutzerkonten für einen Kunden.

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
POST	{baseURL}/v1/customers/{CustomerTenantId}/verifieddo Standard HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um den Kunden anzugeben, für den Sie eine überprüfte Do hinzufügen Standard für.

Name	Type	Erforderlich	Beschreibung
CustomerTenantId	guid	J	Der Wert ist eine guid formatierte CustomerTenantId , mit der Sie einen Kunden angeben können.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

In dieser Tabelle werden die erforderlichen Eigenschaften im Anforderungstext beschrieben.

Name	Type	Erforderlich	Beschreibung
VerifiedDo Standard Name	Zeichenfolge	Ja	Der überprüfte Name Standard.
Domäne	Objekt	Ja	Enthält die Informationen zu "do Standard".
Do Standard Federation Einstellungen	Objekt	Ja (If AuthenticationType = `Federated`)	Die do Standard Partnerverbundeinstellungen, die verwendet werden sollen, wenn dies der Vorgang ist Standard ist ein `Federated` Do Standard und kein `Managed` Do Standard.

Domäne

In dieser Tabelle werden die erforderlichen und optionalen Do Standard Eigenschaften im Anforderungstext beschrieben.

Name	Type	Erforderlich	Beschreibung
AuthenticationType	Zeichenfolge	Ja	Definiert Standard ob es sich um eine `Managed` Do Standard oder eine `Federated` Do Standard handelt. Unterstützte Werte: `Managed`, `Federated`.
Funktion	Zeichenfolge	Ja	Gibt die Do Standard funktion an. Beispiel: `Email`.
IsDefault	nullable boolean	Nein	Gibt an Standard ist die Standard-Do Standard für den Mandanten. Unterstützte Werte: `True`, `False`, `Null`.
IsInitial	nullable boolean	Nein	Gibt an, ob es sich bei der Do Standard um eine erste Do Standard handelt. Unterstützte Werte: `True`, `False`, `Null`.
Name	Zeichenfolge	Ja	Der Domänenname.
RootDo Standard	Zeichenfolge	Nein	Der Name der Stamm-Do Standard.
Status	Zeichenfolge	Ja	Der Status "do Standard" aus. Beispiel: `Verified`. Unterstützte Werte: `Unverified`, `Verified`, `PendingDeletion`.
VerificationMethod	Zeichenfolge	Ja	Der Typ der Do Standard-Überprüfungsmethode. Unterstützte Werte: `None`, `DnsRecord`, `Email`.

Do Standard Partnerverbundeinstellungen

In dieser Tabelle werden die erforderlichen und optionalen Do Standard Federation Einstellungen Eigenschaften im Anforderungstext beschrieben.

Name	Type	Erforderlich	Beschreibung
ActiveLogOnUri	Zeichenfolge	Nein	Der Anmelde-URI, der von Rich-Clients verwendet wird. Diese Eigenschaft ist die STS-Authentifizierungs-URL des Partners.
DefaultInteractiveAuthenticationMethod	Zeichenfolge	Nein	Gibt die Standardauthentifizierungsmethode an, die verwendet werden soll, wenn ein Benutzer über eine interaktive Anmeldung verfügen muss.
FederationBrandName	Zeichenfolge	Nein	Der Partnerverbundbrandname.
IssuerUri	Zeichenfolge	Ja	Der Name des Ausstellers der Zertifikate.
LogOffUri	Zeichenfolge	Ja	Der Abmelde-URI. Diese Eigenschaft beschreibt den Sammelvorgang Standard Abmelde-URI.
MetadataExchangeUri	Zeichenfolge	Nein	Die URL, die den Metadatenaustauschendpunkt angibt, der für die Authentifizierung von Rich-Client-Anwendungen verwendet wird.
NextSigningCertificate	Zeichenfolge	Nein	Das Zertifikat, das für die kommende Zukunft vom ADFS V2 STS zum Signieren von Ansprüchen verwendet wird. Diese Eigenschaft ist eine base64-codierte Darstellung des Zertifikats.
OpenId Verbinden DiscoveryEndpoint	Zeichenfolge	Nein	Der OpenID-Verbinden Discoveryendpunkt des Verbund-IDP-STS.
PassiveLogOnUri	Zeichenfolge	Ja	Der Anmelde-URI, der von älteren passiven Clients verwendet wird. Diese Eigenschaft ist die Adresse zum Senden von Verbundanmeldungsanforderungen.
PreferredAuthenticationProtocol	Zeichenfolge	Ja	Das Format für das Authentifizierungstoken. Beispiel: `WsFed`. Unterstützte Werte: `WsFed`, `Samlp`
PromptLoginBehavior	Zeichenfolge	Ja	Der Eingabeaufforderungs-Anmeldeverhaltenstyp. Beispiel: `TranslateToFreshPasswordAuth`. Unterstützte Werte: `TranslateToFreshPasswordAuth`, `NativeSupportDisabled`
SigningCertificate	Zeichenfolge	Ja	Das derzeit vom ADFS V2 STS zum Signieren von Ansprüchen verwendete Zertifikat. Diese Eigenschaft ist eine base64-codierte Darstellung des Zertifikats.
SigningCertificateUpdateStatus	Zeichenfolge	Nein	Gibt den Aktualisierungsstatus des Signaturzertifikats an.
SigningCertificateUpdateStatus	nullable boolean	Nein	Gibt an, ob der IDP-STS MFA unterstützt. Unterstützte Werte: `True`, `False`, `Null`.

Beispiel für eine Anfrage

POST https://api.partnercenter.microsoft.com/v1/customers/{CustomerTenantId}/verifieddomain HTTP/1.1
Authorization: Bearer <token>
Accept: application/json, text/plain, */*
MS-RequestId: 312b044d-dc41-4b37-c2d5-7d27322d9654
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"

{
    "VerifiedDomainName": "Example.com",
    "Domain": {
        "AuthenticationType": "Federated",
        "Capability": "Email",
        "IsDefault": Null,
        "IsInitial": Null,
        "Name": "Example.com",
        "RootDomain": null,
        "Status": "Verified",
        "VerificationMethod": "None"
    },
    "DomainFederationSettings": {
        "ActiveLogOnUri": "https://sts.microsoftonline.com/FederationPassive/",
        "DefaultInteractiveAuthenticationMethod": "http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/password",
        "FederationBrandName": "FederationBrandName",
        "IssuerUri": "Example.com",
        "LogOffUri": "https://sts.microsoftonline.com/FederationPassive/",
        "MetadataExchangeUri": null,
        "NextSigningCertificate": null,
        "OpenIdConnectDiscoveryEndpoint": "https://sts.contoso.com/adfs/.well-known/openid-configuration",
        "PassiveLogOnUri": "https://sts.microsoftonline.com/Trust/2005/UsernameMixed",
        "PreferredAuthenticationProtocol": "WsFed",
        "PromptLoginBehavior": "TranslateToFreshPasswordAuth",
        "SigningCertificate": <Certificate Signature goes here>,
        "SigningCertificateUpdateStatus": null,
        "SupportsMfa": true
    }
}

REST-Antwort

Wenn die API erfolgreich verläuft, wird eine Do Standard Ressource für die neue überprüfte Do Standard zurückgegeben.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Beispielantwort

HTTP/1.1 201 Created
Content-Length: 206
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
MS-RequestId: 312b044d-dc41-4b37-c2d5-7d27322d9654
Date: Tue, 14 Feb 2017 20:06:02 GMT

{
    "authenticationType": "federated",
    "capability": "email",
    "isDefault": false,
    "isInitial": false,
    "name": "Example.com",
    "status": "verified",
    "verificationMethod": "dns_record"
}

Share via