Exportar (0) Imprimir
Expandir Tudo

Adicionar certificado de serviço

Atualizado: fevereiro de 2015

A operação assíncrona Add Service Certificate adiciona um certificado a um serviço em nuvem.

A solicitação Add Service Certificate pode ser especificada da seguinte maneira. Substitua <subscription-id> pela ID da assinatura e <service-name> pelo nome do prefixo DNS do serviço em nuvem.

 

Método URI de solicitação

POST

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

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

Nenhuma.

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Descrição

Content-Type

Obrigatória. Defina este cabeçalho como application/xml.

x-ms-version

Obrigatória. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 01.10.09 ou posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte Controle de versão de gerenciamento de serviço.

Formato do corpo da solicitação:


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

A tabela a seguir descreve os elementos no corpo da solicitação.

 

Nome do elemento Descrição

Dados

Obrigatória. Especifica a forma codificada em base 64 do arquivo .pfx ou .cer.

noteObservação
O certificado de serviço é adicionado como um arquivo .pfx ou .cer. Ao recuperar o certificado de serviço usando a operação Listar certificados de serviço serviço ou Obter certificado de serviço, apenas a parte pública do certificado é retornada como um arquivo .cer.

CertificateFormat

Obrigatória. Especifica o formato do certificado de serviço.

Os possíveis valores são:

  • pfx

  • cer

Senha

Especifica a senha de um certificado .pfx. Um certificado .cer não exige uma senha.

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Uma operação bem-sucedida retorna o código de status 200 (OK). Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

x-ms-request-id

Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento. Para uma operação assíncrona, você pode chamar Obter status da operação com o valor do cabeçalho para determinar se a operação foi concluída, se falhou ou se ainda está em andamento.

O método a seguir constrói uma solicitação para adicionar um certificado de serviço, envia a solicitação para o serviço e retorna a ID da solicitação.


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

A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2015 Microsoft