Partilhar via

Amostra de código: ASP.NET formas simples

  • Artigo

Atualizado: 19 de junho de 2015

Aplica-se a: Azure

Esta amostra ilustra como integrar o ACS com uma aplicação ASP.NET Web Forms. O código desta amostra está localizado na subdirectória ASPNETSimpleForms (C#\Websites/ASPNETSimpleForms) do pacote de amostras de código Microsoft Azure Ative Directory Controlo de Acesso (ACS).

Pré-requisitos

Para executar esta amostra, você precisará:

  1. Uma conta no portal do Azure e um Controlo de Acesso espaço de nome.

  2. Visual Studio 2010 (qualquer versão)

  3. Fundação Windows Identidade SDK

Para mais detalhes, consulte os pré-requisitos acs (https://go.microsoft.com/fwlink/?LinkId=221065).

Configurar a amostra

A configuração ACS necessária para esta amostra pode ser realizada utilizando o Portal de Gestão ACS ou o Serviço de Gestão ACS. Este tópico descreve ambas as opções.

  1. Opção 1: Configurar a amostra utilizando o Portal de Gestão ACS

  2. Opção 2: Configurar a amostra utilizando o Serviço de Gestão ACS

Opção 1: Configurar a amostra utilizando o Portal de Gestão ACS

Para configurar a amostra utilizando o Portal de Gestão ACS

  1. Vá ao Portal de Gestão Microsoft Azure (https://manage.WindowsAzure.com), inscreva-se e, em seguida, clique em Ative Directory. (Dica de resolução de problemas: o item "Ative Directory" está em falta ou não está disponível)

  2. Para criar um Controlo de Acesso espaço de nome, clique em Novos, clique em Serviços de Aplicações, clique Controlo de Acesso e, em seguida, clique em "Criar" Quick. (Ou, clique Controlo de Acesso Espaços de Nome antes de clicar em New.)

  3. Para gerir um Controlo de Acesso espaço de nome, selecione o espaço de nomes e, em seguida, clique em Gerir. (Ou, clique Controlo de Acesso Espaços de Nome, selecione o espaço de nomes e, em seguida, clique em Gerir.)

    Esta ação abre o portal de gestão do Serviço Controlo de Acesso.

  4. Para estabelecer relações com os fornecedores de identidade, gostaria que os utilizadores do seu website usassem ao iniciar sessão, clique em Fornecedores de Identidade e adicione Yahoo e Google. Em seguida, clique em Casa para voltar à página principal.

  5. Para registar a sua aplicação com ACS, clique em Aplicações de Partido De Gestão, clique em Adicionar e, em seguida, introduza as seguintes informações no formulário:

    • No campo Nome , insira a amostra de formulários simples ASPNET.

    • No campo Realm , insira https://localhost:62000/

    • No campo URL de retorno , insira https://localhost:62000/

    • Selecione SAML 2.0 da caixa de lista de drop-down do formato Token .

    • Na secção de fornecedores de identidade, selecione Google, Windows Live ID e Yahoo!

    • No campo de assinatura token , selecione Use o certificado de espaço de serviço (standard).

    • Deixe os outros campos nos seus valores predefinidos.

  6. Clique em Guardar e, em seguida, navegue para a página principal.

  7. Com a sua aplicação de partidos cingindo-se, é agora tempo de criar as regras que determinam as alegações que a ACS irá emitir à sua aplicação. Nesta amostra, passaremos simplesmente por todas as reclamações emitidas pelo fornecedor de identidade. Para criar esta regra, clique em Grupos de Regras e, em seguida, clique em "Grupo de Regras Predefinidos" para amostra de formas simples ASPNET. Na parte inferior da página, clique no link Gerar . Certifique-se de que os três fornecedores de identidade Yahoo!, Google, e são selecionados e clique em Gerar. Por fim, clique em Guardar e navegar de volta para a página principal.

  8. Com ACS configurado, aberto Visual Studio.

Opção 2: Configurar a amostra utilizando o Serviço de Gestão ACS

Para configurar a amostra utilizando o Serviço de Gestão ACS

  1. Para configurar a amostra, abra a Configuração de Amostras.cs (acs\Management\ManagementService\Common). Substitua os espaços reservados na classe SamplesConfiguration na biblioteca da classe Comum por informações sobre o seu Controlo de Acesso espaço de nome. Pode encontrar a informação no Portal de Gestão da ACS.

    Para navegar no Portal de Gestão ACS: Vá ao Portal de Gestão Microsoft Azure (https://manage.WindowsAzure.com), inscreva-se e, em seguida, clique em Ative Directory. (Dica de resolução de problemas: o item "Ative Directory" está em falta ou não está disponível) Para gerir um Controlo de Acesso espaço de nome, selecione o espaço de nomes e, em seguida, clique em Gerir. (Ou, clique Controlo de Acesso Espaços de Nome, selecione o espaço de nomes e, em seguida, clique em Gerir.)

    • ServiceNamespace - Insira o nome do seu Controlo de Acesso espaço de nome.

    • ManagementServiceIdentityName - Introduza o nome de uma conta de serviço de gestão ACS. O padrão é ManagementClient.

      Para encontrar o nome da conta do serviço de gestão, no Portal de Gestão acs, clique no serviço Gestão. As contas estão listadas pelo nome em Contas de Serviço de Gestão.

    • ManagementServiceIdentityKey - Introduza a palavra-passe para a conta de serviço de gestão.

      Para encontrar a senha de conta de serviço de gestão, no Portal de Gestão ACS, clique no serviço De Gestão. Clique no nome de uma conta de serviço de gestão e, em seguida, em Credenciais, clique em Palavra-passe. A palavra-passe aparece no campo Palavra-passe . Para copiar a palavra-passe, clique em Mostrar Palavra-Passe.

  2. Executar a aplicação ConfigureSample em Visual Studio, que configurará ACS para executar esta amostra.

Executando a amostra

Para executar a amostra

  1. Abra a amostra localizada em Websites\ASPNETSimpleForms\ASPNETSimpleForms.sln em Visual Studio.

  2. Prima F5 para iniciar a aplicação.

  3. Feche o navegador para parar a aplicação.

  4. Clique com o direito no projeto e selecione Adicionar Referência STS no menu de contexto.

  5. Na caixa de diálogo, introduza a raiz da aplicação web no campo URI de aplicação e clique em Seguinte. Para esta amostra, este valor é https://localhost:62000/

    Nota

    O corte de fuga é importante, uma vez que alinha-se com os valores que inseriu no ACS para a sua festa de confiação. O assistente emitirá um aviso de que o seu site não está a utilizar SSL. Aceite este aviso clicando no botão Sim , mas lembre-se que um site de produção deve usar quase sempre SSL para este tipo de cenários.

  6. Na janela seguinte, selecione o botão de rádio Use EXISTENTE STS e introduza o URI do WS-Federation metadados publicados pelo seu Controlo de Acesso espaço de nome. Este URI pode ser encontrado no portal no âmbito da Integração de Aplicações. Se o seu Controlo de Acesso espaço de nome for acssamples, o URI é https://acssamples. accesscontrol.windows.net/FederationMetadata/2007-06/FederationMetadata.xml. Depois de introduzir o valor, clique em Seguinte.

  7. Uma vez que o seu website não necessita de tokens encriptados, clique em Seguinte nas restantes caixas de diálogo e, em seguida, clique em Terminar.

  8. Tanto o ACS como a sua aplicação estão agora configurados. Prima F5 em Visual Studio para executar o pedido. O seu navegador será levado para a página ACS home realm Discovery.

  9. Clique em Yahoo! ou Google e o seu navegador será levado para esse fornecedor de identidade.

  10. Uma vez que o seu navegador esteja no fornecedor de identidade, introduza credenciais para uma conta de teste e aceite o formulário de consentimento do utilizador.

  11. O seu navegador deve voltar a https://localhost:62000/. Note que o nome da sua identidade de teste aparece na secção superior direita da página. Estes dados foram emitidos pelo fornecedor de identidade, e foram devolvidos à sua aplicação através da ACS.