Esporta (0) Stampa
Espandi tutto

Aggiungere un certificato di servizio

Aggiornamento: settembre 2014

L'operazione asincrona Add Service Certificate aggiunge un certificato a un servizio cloud.

La richiesta di Add Service Certificate può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione e <service-name> con il nome del prefisso DNS del servizio cloud.

 

Metodo URI della richiesta

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<service-name>/certificates

È necessario verificare che la richiesta effettuata al servizio di gestione sia sicura. Per ulteriori dettagli, vedere Autenticazione di richieste di gestione dei servizi.

Nessuna.

Nella tabella seguente vengono descritte le intestazioni delle richieste.

 

Intestazione della richiesta Descrizione

Content-Type

Obbligatoria. Impostare questa intestazione su application/xml.

x-ms-version

Obbligatoria. Specifica la versione dell'operazione da utilizzare per questa richiesta. Questa intestazione deve essere impostata su 01/10/2009 o una versione successiva. Per ulteriori informazioni sulle intestazioni di controllo delle versioni, vedere Controllo delle versioni di gestione del servizio.

Il formato del corpo della richiesta è il seguente:


<?xml version="1.0" encoding="utf-8"?>
<CertificateFile xmlns=”http://schemas.microsoft.com/windowsazure”>
  <Data>base64-encoded-file</Data>
  <CertificateFormat>file-format</CertificateFormat>
  <Password>pfx-file-password</Password>
</CertificateFile>

Nella tabella indicata di seguito vengono descritti gli elementi nel corpo della richiesta.

 

Nome elemento Descrizione

Dati

Obbligatoria. Specifica il formato con codifica Base 64 del file con estensione pfx o cer.

noteNota
Il certificato di servizio viene aggiunto come file con estensione pfx o cer. Quando si recupera il certificato del servizio tramite l'operazione Elencare i certificati di servizio o Ottenere il certificato del servizio, solo la parte pubblica del certificato viene restituita come file con estensione cer.

CertificateFormat

Obbligatoria. Specifica il formato del certificato di servizio.

I valori possibili sono:

  • pfx

  • cer

Password

Specifica la password per un certificato pfx. Un certificato cer non richiede una password.

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Un'operazione completata correttamente restituisce il codice di stato 200 (OK). Per informazioni sui codici di stato, vedere Codici di stato e di errore relativi alla gestione dei servizi.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta Descrizione

x-ms-request-id

Valore che identifica in modo univoco una richiesta effettuata nel servizio di gestione. Per un'operazione asincrona, è possibile chiamare Ottenere lo stato delle operazioni con il valore dell'intestazione per determinare se l'operazione è stata completata, ha avuto esito negativo o è ancora in corso.

Il metodo seguente costruisce una richiesta per aggiungere un certificato di servizio, invia la richiesta al servizio e restituisce l'ID di richiesta


public static string AddCertificate(string subscriptionId, string applicationName, X509Certificate2 managementCertificate, string pfxPath, string password)
{
    // Construct the request URI.    var req = (HttpWebRequest)WebRequest.Create(string.Format("https://management.core.windows.net/{0}/services/hostedservices/{1}/certificates", subscriptionId, applicationName));

    // Set the request method and the content type for the request.
    req.Method = "POST";
    req.ContentType = "application/xml";

    // Add the x-ms-version header.
    req.Headers.Add("x-ms-version", "2009-10-01");

    // Add the certificate.
    req.ClientCertificates.Add(managementCertificate);

    // Construct the request body.
    using (var writer = new StreamWriter(req.GetRequestStream()))
    {
        writer.Write(string.Format(@"<?xml version=""1.0"" encoding=""utf-8""?>
                                   <CertificateFile xmlns=""http://schemas.microsoft.com/windowsazure"">
                                   <Data>{0}</Data>
                                   <CertificateFormat>pfx</CertificateFormat>
                                   <Password>{1}</Password>
                                   </CertificateFile>", 
                                   Convert.ToBase64String(File.ReadAllBytes(pfxPath)), 
                                   password));
    }

    // Submit the request and return the request ID.
    return req.GetResponse().Headers["x-ms-request-id"];
}

Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft