Tutorial CAS – FoxDevelop

Implementação do CAS

jack — Thu, 06 Aug 2026 08:11:02 +0000

Ideia de implementação da versão antiga do CAS

Princípio central (protocolo CAS 1.0)

O usuário acessa a página protegida /admin/admin.aspx
A configuração de permissões do web.config bloqueia usuários anônimos e redireciona automaticamente para a página de login CasEnter.aspx
CasEnter.aspx verifica se existe o parâmetro ticket na URL

Sem ticket: redireciona para o endereço de login do servidor CAS, enviando o endereço do site atual no parâmetro service
Com ticket: chama a API serviceValidate para validar o billete no servidor CAS

O CAS retorna um XML, o nome de usuário logado é extraído do conteúdo
Após validação bem‑sucedida, executa FormsAuthentication.SetAuthCookie() para gravar o billete local do Forms e redireciona para a página alvo
Nas próximas requisições aos diretórios protegidos, o ASP.NET Forms reconhece o estado de autenticação

Configuração do web.config

<system.web>
  <authentication mode="Forms">
    
    <forms loginUrl="CasEnter.aspx" 
           defaultUrl="admin/admin.aspx" 
           name=".LoginFormsTicket" 
           path="/" 
           timeout="40" 
           protection="All">
    forms>
  authentication>
  <authorization>
    <allow users="*"/>
  authorization>
system.web>


<location path="admin">
  <system.web>
    <authorization>
      <deny users="?"/>
    authorization>
  system.web>
location>

Servidores CAS mais novos forçam HTTPS por padrão, o campo casUrl deve ser preenchido com https://127.0.0.1:8443/cas/

<appSettings>
  
  <add key="casUrl" value="https://127.0.0.1:8443/cas/"/>
appSettings>

Código da página CasEnter.aspx

1. CasEnter.aspx código frontend

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="CasEnter.aspx.cs" Inherits="CasStudy.Web.CasEnter" %>
html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Login intermediário do CAStitle>
head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:Label ID="Label1" runat="server">asp:Label><br />
            <asp:HyperLink ID="HyperLink1" runat="server">Refazer autenticaçãoasp:HyperLink>
        div>
    form>
body>
html>

2. CasEnter.aspx.cs lógica de backend

Interface atualizada para CAS3.0 p3/serviceValidate
Adicionado HttpClient para substituir o WebClient obsoleto

Adicionado suporte a certificados autoassinados (obrigatório para testes locais com o CAS novo)
Tratamento de namespace para o XML retornado pelo CAS

using System;
using System.Configuration;
using System.Net;
using System.Net.Http;
using System.Xml;
using System.Web.Security;

public partial class CasEnter : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        string casHost = ConfigurationManager.AppSettings["casUrl"];
        string ticket = Request.QueryString["ticket"];
        string service = Request.Url.GetLeftPart(UriPartial.Path);

        // Sem billete, redireciona para página de login do CAS
        if (string.IsNullOrEmpty(ticket))
        {
            string redirectUrl = $"{casHost}login?service={Uri.EscapeDataString(service)}";
            Response.Redirect(redirectUrl);
            return;
        }

        // Validar o ticket
        string username = ValidateTicket(casHost, ticket, service);
        if (string.IsNullOrEmpty(username))
        {
            Label1.Text = "Desculpe! A autenticação do CAS falhou, tente novamente.";
            HyperLink1.NavigateUrl = Request.Url.AbsolutePath;
        }
        else
        {
            // Gravar billete de autenticação Forms e concluir login local
            FormsAuthentication.SetAuthCookie(username, false);
            // Redirecionar para a página alvo
            Response.Redirect(FormsAuthentication.DefaultUrl);
        }
    }

    /// <summary>
    /// Validação de billete com CAS3.0 p3/serviceValidate
    /// summary>
    private string ValidateTicket(string casHost, string ticket, string service)
    {
        // Versões novas do CAS recomendam p3/serviceValidate (protocolo CAS3.0)
        string validateUrl = $"{casHost}p3/serviceValidate?ticket={Uri.EscapeDataString(ticket)}&service={Uri.EscapeDataString(service)}";

        // Apenas para teste local: permitir certificados SSL não confiáveis (remova em ambiente de produção!)
        ServicePointManager.ServerCertificateValidationCallback += (s, cert, chain, err) => true;

        using var httpClient = new HttpClient();
        string xml = httpClient.GetStringAsync(validateUrl).Result;

        XmlDocument doc = new XmlDocument();
        doc.LoadXml(xml);
        XmlNamespaceManager nsMgr = new XmlNamespaceManager(doc.NameTable);
        // Namespace do XML retornado pelo CAS3
        nsMgr.AddNamespace("cas", "http://www.yale.edu/tp/cas");

        // Localizar nó do usuário
        XmlNode userNode = doc.SelectSingleNode("//cas:authenticationSuccess/cas:user", nsMgr);
        return userNode?.InnerText;
    }
}

Implementação do CAS

Instalação

jack — Thu, 06 Aug 2026 07:58:39 +0000

Instalação de versões antigas – Instruções para CAS anterior à versão 5.0

O servidor CAS é desenvolvido em Java e depende de dois ambientes principais para funcionar:

JDK (Kit de Desenvolvimento Java): Contém a Máquina Virtual Java (JVM), é a base para executar aplicações Java.
Tomcat (Contêiner Web): Utilizado para implantar e rodar o programa web war do CAS.

Ordem recomendada de instalação: instale primeiro o JDK → depois instale o Tomcat (durante a instalação, o Tomcat detecta automaticamente o JDK instalado na máquina).

Pré‑requisitos

1. JDK

Versão: (JDK) Java 17
Link direto: Java Downloads | Oracle

Observação: O JDK7 é uma versão descontinuada, compatível apenas com versões antigas do CAS; não é recomendado para novos projetos.

2. Apache Tomcat

Versão: Tomcat (versão instalável para Windows)
Apache Tomcat® – Welcome!

Passo a passo da instalação

Instalar o JDK
- Execute o arquivo de instalação exe, você pode definir um caminho de instalação personalizado.
- 【Ponto chave】Após terminar a instalação, configure as variáveis de ambiente: JAVA_HOME e Path, para que o Tomcat identifique corretamente o ambiente Java.
Instalar o Tomcat7
- Execute o instalador, ele fará uma varredura automática para localizar o JDK já instalado.
- Você pode alterar a porta do Tomcat (padrão 8080) e configurar usuário e senha de administração.
- Opções na tela final da instalação:
- Run Apache Tomcat: Se marcado, o serviço Tomcat será iniciado automaticamente ao clicar em Finalizar.
- Show Readme: Você pode desmarcar essa opção, não é necessário ler o documento de apresentação.
- Clique em Finish para concluir a instalação.

Configurar SSL/HTTPS no Tomcat

Contexto importante: O protocolo CAS exige obrigatoriamente HTTPS no servidor, não aceita HTTP, por isso é preciso configurar um certificado SSL para o Tomcat.

Use a ferramenta keytool inclusa no JDK para gerar um armazenamento de chaves JKS (certificado autoassinado).
Edite o arquivo conf/server.xml do Tomcat e habilite o conector SSL.
Reinicie o Tomcat e acesse https://localhost:8443 para validar o HTTPS.

Gerar certificado autoassinado (JKS)

Preparativos

Crie uma pasta para armazenar certificados: exemplo C:\Keys
Execute o cmd como administrador
> No Windows7/10/11, ao usar um cmd comum para gravar arquivos na raiz da unidade C, ocorrerão erros de permissão.
Acesse a pasta bin do JDK/JRE.

cd "c:\Program Files\Java\jre\bin"

Comando modelo (compatível também com versões novas do JDK)

keytool -genkey -alias tomcat -keyalg RSA -storepass changeit -keystore c:\Keys\.keystore -validity 36000

Explicação dos parâmetros

Parâmetro	Significado
`-genkey`	Gera um par de chaves criptográficas
`-alias tomcat`	Apelido do certificado, pode ser personalizado
`-keyalg RSA`	Algoritmo de criptografia, padrão RSA
`-storepass changeit`	Senha do armazenamento de chaves (anote‑a, será usada na configuração posterior do Tomcat)
`-keystore c:\Keys\.keystore`	Caminho de saída do arquivo de certificado
`-validity 36000`	Validade do certificado em dias

Dados para preenchimento interativo

Após rodar o comando, informe os dados na sequência:

Nome e sobrenome: informe o domínio (para ambiente de estudo pode preencher qualquer valor)
Unidade organizacional, organização, cidade, estado, código do país (cn)
Confirme os dados digitando y
Senha da chave: aperte Enter diretamente, use a mesma senha do armazenamento de chaves

Comando para visualizar o certificado

keytool -list -keystore "C:\Keys\.keystore"

Informe a senha. Se as informações forem exibidas corretamente, o certificado foi gerado com sucesso.

Configurar o conector SSL no Tomcat server.xml

Abra o arquivo Tomcat/conf/server.xml
Localize o Conector SSL comentado, remova os comentários e altere o caminho do certificado e a senha.

<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
    maxThreads="150" scheme="https" secure="true"
    clientAuth="false" sslProtocol="TLS"
    keystoreFile="C:\Keys\.keystore"
    keystorePass="changeit" />

Detalhes dos parâmetros

port="8443": Porta HTTPS padrão do Tomcat (a porta HTTPS oficial é 443; se quiser usar ela, fique atento a permissões e conflitos de porta)
keystoreFile: Caminho absoluto do arquivo de certificado que você gerou
keystorePass: Senha do armazenamento de chaves definida no keytool
clientAuth="false": Não exige certificado do cliente (mantenha false para ambientes de estudo)

Método de validação

Inicie o Tomcat e acesse pelo navegador:
https://127.0.0.1:8443

Navegadores exibirão aviso de site inseguro para certificados autoassinados, isso é normal. Em ambiente de produção compre um certificado CA confiável.

Instalação do CAS 5.0+

1. Obter os recursos

O CAS 5.0+ abandona o modelo tradicional war + Tomcat. Ele é baseado no SpringBoot, distribuído como Jar executável independente, sem necessidade de Tomcat externo.

Servidor CAS (Server)

Gere pacotes de implantação online com o CAS Initializr
https://casinitializr.apereo.org

2. Passos para implantar o servidor CAS

Acesse o CAS Initializr

Selecione a versão do CAS: 7.0.x (versão estável mais recente)
Selecione os módulos básicos: Core / Web / SSL
Gere e baixe o arquivo cas.war (ou gere diretamente o arquivo independente cas.jar)

Escolha um dos dois formatos de empacotamento:

Modo A (recomendado): Standalone (Jar independente), vem com Tomcat embutido, pronto para uso

Modo B: Pacote War tradicional, para implantar em um Tomcat externo (não recomendado)

Implantação no modo Jar independente (solução mais utilizada)
1) Baixe o arquivo cas.jar
2) Crie a pasta de configuração ./etc/cas/config e o arquivo de configuração cas.properties
3) Comando de inicialização (obrigatório Java 17 ou superior)

java -jar cas.jar

Sobre porta e HTTPS
Porta padrão do Tomcat embutido: 8443 (HTTPS)
Nas versões novas o HTTPS é obrigatório por padrão, seguindo as mesmas regras das versões antigas.

3. Endereço de acesso

https://127.0.0.1:8443/cas

Instalação

Apresentação

jack — Thu, 06 Aug 2026 07:39:26 +0000

Conceitos

1. CAS

CAS (Central Authentication Service, Serviço Central de Autenticação)
Um framework open‑source de SSO Web (Single Sign‑On, Login Único) criado pela Universidade de Yale.

2. SSO (Login Único)

Reúne a validação de login de vários sistemas web em um único endereço.

Características: Os aplicativos trocam dados por meio de protocolos web (HTTPS), contando com um ponto de login global exclusivo

Entendimento simples: Faça login uma única vez no centro de autenticação no mesmo navegador e acesse todos os sites confiáveis sem precisar logar novamente

3. Três papéis do sistema SSO

User: Usuário final (navegador web)
Aplicativos web (múltiplos sistemas de negócio)
Centro de autenticação SSO (instância única)

4. Três princípios centrais do SSO

Todas as operações de login de contas são executadas no centro de autenticação SSO;
O centro de autenticação dispõe de mecanismos para avisar cada aplicativo web se o usuário já foi autenticado;
Uma relação de confiança é estabelecida antecipadamente entre o centro de autenticação e todos os aplicativos web de negócio.

Dois componentes principais

CAS Server (Servidor de autenticação)

Aplicativo web implantado de forma independente, ele funciona como o único centro de autenticação
Responsabilidades: Receber login e senha, validar a identidade do usuário; emitir tickets, gerenciar o cookie de sessão global TGC

CAS Client (Cliente embutido em cada sistema de negócio)

É implantado dentro de cada aplicativo web de negócio, normalmente implementado como um filtro Filter
Responsabilidades: Interceptar requisições para recursos protegidos; quando o usuário não estiver logado, redireciona automaticamente o navegador para a página de login do CAS Server

Fluxo de operação

Usuário acessa recursos do sistema de negócio → O CAS Client intercepta a requisição e constata a ausência do Service Ticket
O cliente redireciona o navegador para o endereço de login do CAS Server, enviando o endereço do sistema de negócio (Service)
O usuário informa login e senha no CAS Server para concluir a autenticação
- Login bem‑sucedido: O CAS Server grava no navegador o TGC (Ticket Granting Cookie), cookie de sessão global
- Gera um ticket de uso único: Service Ticket (ST)
O CAS Server redireciona novamente o navegador para o sistema de negócio, incluindo o parâmetro de URL Ticket=xxx
O CAS Client do sistema de negócio dispara uma requisição servidor‑para‑servidor em segundo plano, enviando endereço Service e Ticket para validar a autenticidade do ticket no CAS Server
O CAS Server valida o ticket e retorna os dados de identidade do usuário (nome de usuário e demais informações)
Com validação aprovada, o sistema de negócio cria uma sessão local e o usuário consegue navegar pelas páginas normalmente

Função do TGC: Enquanto o navegador mantiver o cookie TGC, ao acessar outros sistemas integrados ao CAS não será exibida a tela de login, e o login único ocorrerá de forma automática.

Apresentação