Exportar (0) Imprimir
Expandir todo

Agregar certificado de servicio

Actualizado: febrero de 2015

La operación asincrónica Add Service Certificate agrega un certificado a un servicio en la nube.

La solicitud Add Service Certificate se puede especificar como sigue. Reemplace <subscription-id> por el identificador de la suscripción y <service-name> por el nombre del prefijo DNS del servicio en la nube.

 

Método URI de solicitud

POST

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

Debe asegurarse de que la solicitud que se realice al servicio de administración sea segura. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

Ninguna.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

Content-Type

Requerido. Establezca este encabezado en application/xml.

x-ms-version

Requerido. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debería establecerse en 01.10.09 o posterior. Para obtener más información acerca de los encabezados de control de versiones, vea Control de versiones de la administración del servicio.

El formato del cuerpo de la solicitud es el siguiente:


<?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>

En la tabla siguiente se describen los elementos del cuerpo de la solicitud.

 

Nombre del elemento Descripción

Datos

Requerido. Especifica la forma del archivo .cer o .pfx codificada en base 64.

noteNota
El certificado del servicio se agrega como un archivo .pfx o .cer. Al recuperar el certificado del servicio mediante la operación Enumerar certificados de servicio utilizando o Obtener certificado del servicio, solo se devuelve la parte pública del certificado como archivo .cer.

CertificateFormat

Requerido. Especifica el formato del certificado de servicio.

Los valores posibles son:

  • pfx

  • cer

Contraseña

Especifica la contraseña para un certificado .pfx. Un certificado .cer no precisa una contraseña.

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Una operación correcta devuelve el código de estado 200 (Correcto). Para obtener información acerca de los códigos de estado, vea Estado y códigos de error de administración del servicio.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

x-ms-request-id

Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración. Para una operación asincrónica, puede llamar a Obtener estado de la operación con el valor del encabezado para determinar si se ha completado la operación, ha generado un error o aún está en curso.

El método siguiente genera una solicitud para agregar un certificado de servicio, envía la solicitud al servicio, y devuelve el identificador de la solicitud.


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

Mostrar:
© 2015 Microsoft