Mevcut bir müşteri için onaylanmış etki alanları listesine doğrulanmış bir etki alanı ekleme

Uygulama:İş Ortağı Merkezi | İş Ortağı Merkezi 21Vianet | İş Ortağı Merkezi Microsoft Bulut Almanya için | İş Ortağı Merkezi için Microsoft Cloud for US Government

Mevcut bir müşteri için onaylı etki alanları listesine doğrulanmış etki alanı ekleme.

Önkoşullar

• Etki alanı kayıt şirketi olan bir İş Ortağınız olmalıdır.

• kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamasını destekler.

• Müşteri kimliği ( customer-tenant-id ). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi'den CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği () ile customer-tenant-id aynıdır.

Doğrulanmış etki alanı ekleme

Etki alanı kayıt şirketi olan bir İş Ortağınız varsa API'yi kullanarak mevcut bir müşterinin etki alanları listesine yeni bir Etki alanı verifieddomain kaynağı ekleyebilirsiniz. verifieddomain Bunu yapmak için CustomerTenantId'sini kullanarak müşteriyi tanıyın. VerifiedDomainName özelliği için bir değer belirtin. İstekte gerekli Name, Capability, AuthenticationType, Status ve VerificationMethod özelliklerine sahip bir Etki alanı kaynağı girin. Yeni Etki Alanının federasyon etki alanı olduğunu belirtmek için, Etki alanı kaynağında AuthenticationType özelliğini olarak ayarlayın ve İstek'e bir DomainFederationSettings kaynağı dahil ederek. Yöntem başarılı olursa Yanıt, yeni doğrulanmış etki alanı için bir Etki alanı kaynağı içerir.

Özel doğrulanmış etki alanları

Özel bir doğrulanmış etki alanı eklerken, onmicrosoft.comüzerinde kayıtlı olmayan bir etki alanı, CustomerUser.immutableId özelliğini etki alanını eklemekte olan müşteri için benzersiz bir kimlik değerine ayarlamış olur. Bu benzersiz tanımlayıcı, etki alanı doğrulandığında doğrulama işlemi sırasında gereklidir. Müşteri kullanıcı hesapları hakkında daha fazla bilgi için bkz. Müşteri için kullanıcı hesapları oluşturma.

REST isteği

İstek söz dizimi

URI parametresi

Doğrulanmış bir etki alanı eklemekte olduğunu müşteriyi belirtmek için aşağıdaki sorgu parametresini kullanın.

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Bu tablo, istek gövdesinde gerekli özellikleri açıklar.

Etki alanı

Bu tablo, istek gövdesinde gerekli ve isteğe bağlı Etki alanı özelliklerini açıklar.

Etki alanı Federasyon ayarları

Bu tabloda, istek gövdesinde gerekli ve isteğe bağlı Domainfederationsettings özellikleri açıklanmaktadır.

İstek örneği

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 yanıtı

Başarılı olursa, bu API yeni doğrulanmış etki alanı için bir etki alanı kaynağı döndürür.

Yanıt başarısı ve hata kodları

Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Iş ortağı MERKEZI Rest hata kodları.

Yanıt örneği

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"
}