CAS チュートリアル – FoxDevelop https://www.foxdevelop.com 独立ソフトウェア開発スタジオ Thu, 06 Aug 2026 08:07:14 +0000 ja hourly 1 https://wordpress.org/?v=7.0.2 https://www.foxdevelop.com/wp-content/uploads/2026/05/fox-svgrepo-com-1.png CAS チュートリアル – FoxDevelop https://www.foxdevelop.com 32 32 CASの実装 https://www.foxdevelop.com/ja/2026/08/06/cas%e3%81%ae%e5%ae%9f%e8%a3%85/ https://www.foxdevelop.com/ja/2026/08/06/cas%e3%81%ae%e5%ae%9f%e8%a3%85/#respond Thu, 06 Aug 2026 08:07:14 +0000 https://www.foxdevelop.com/?p=7823 旧バージョンCASの実装方針

コア原理（CAS 1.0プロトコル）

  1. ユーザーが保護対象ページ /admin/admin.aspx にアクセス
  2. web.config の権限設定が匿名ユーザーを遮断し、ログインページ CasEnter.aspx へ自動リダイレクト
  3. CasEnter.aspx はURLに ticket パラメータが存在するか判定
  • ticketなし：CASサーバーのログイン先へリダイレクト、自サイトアドレスを service として渡す
  • ticket付き：serviceValidate APIを呼び出しCASサーバーでチケット検証を実行
  1. CASから返却されたXMLからログインユーザー名をパース
  2. 検証成功後 FormsAuthentication.SetAuthCookie() を実行しローカルForms認証チケットを発行、対象ページへ遷移
  3. 以降の保護ディレクトリアクセスはASP.NET Formsがログイン状態を管理

web.config 設定

<system.web>
  <authentication mode="Forms">
    <!-- loginUrlはCAS入口中継ページのCasEnter.aspxを指定 -->
    <forms loginUrl="CasEnter.aspx" 
           defaultUrl="admin/admin.aspx" 
           name=".LoginFormsTicket" 
           path="/" 
           timeout="40" 
           protection="All">
    </forms>
  </authentication>
  <authorization>
    <allow users="*"/>
  </authorization>
</system.web>

<!-- adminディレクトリを匿名アクセス禁止に制限 -->
<location path="admin">
  <system.web>
    <authorization>
      <deny users="?"/>
    </authorization>
  </system.web>
</location>

新しいCASサーバーは標準でHTTPSを強制します。casUrl には https://127.0.0.1:8443/cas/ を記述してください

<appSettings>
  <!-- CAS7向けアドレス、末尾にスラッシュ必須 -->
  <add key="casUrl" value="https://127.0.0.1:8443/cas/"/>
</appSettings>

CasEnter.aspx ページコード

1. CasEnter.aspx フロント側
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="CasEnter.aspx.cs" Inherits="CasStudy.Web.CasEnter" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>CAS中継ログイン</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:Label ID="Label1" runat="server"></asp:Label><br />
            <asp:HyperLink ID="HyperLink1" runat="server">再認証</asp:HyperLink>
        </div>
    </form>
</body>
</html>
2. CasEnter.aspx.cs コードビハインド


APIをCAS3.0の p3/serviceValidate に更新
廃止されたWebClientの代わりにHttpClientを使用

自己署名証明書への対応追加（新CASのローカル検証に必須）
CAS応答XMLの名前空間を処理

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);

        // チケット無しの場合CASログインページへ遷移
        if (string.IsNullOrEmpty(ticket))
        {
            string redirectUrl = $"{casHost}login?service={Uri.EscapeDataString(service)}";
            Response.Redirect(redirectUrl);
            return;
        }

        // チケット検証実行
        string username = ValidateTicket(casHost, ticket, service);
        if (string.IsNullOrEmpty(username))
        {
            Label1.Text = "申し訳ありません。CAS認証に失敗しました。再試行してください。";
            HyperLink1.NavigateUrl = Request.Url.AbsolutePath;
        }
        else
        {
            // Forms認証チケットを書き込みローカルログイン完了
            FormsAuthentication.SetAuthCookie(username, false);
            // 目的のページへリダイレクト
            Response.Redirect(FormsAuthentication.DefaultUrl);
        }
    }

    /// <summary>
    /// CAS3.0 p3/serviceValidate によるチケット検証
    /// </summary>
    private string ValidateTicket(string casHost, string ticket, string service)
    {
        // 新CASでは p3/serviceValidate(CAS3.0プロトコル)の利用が推奨
        string validateUrl = $"{casHost}p3/serviceValidate?ticket={Uri.EscapeDataString(ticket)}&service={Uri.EscapeDataString(service)}";

        // ローカルテスト用：信頼されていないSSL証明書を許可（本番環境では削除！）
        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);
        // CAS3応答XMLの名前空間
        nsMgr.AddNamespace("cas", "http://www.yale.edu/tp/cas");

        // ユーザーノードを取得
        XmlNode userNode = doc.SelectSingleNode("//cas:authenticationSuccess/cas:user", nsMgr);
        return userNode?.InnerText;
    }
}

CASの実装

]]> https://www.foxdevelop.com/ja/2026/08/06/cas%e3%81%ae%e5%ae%9f%e8%a3%85/feed/ 0 インストール https://www.foxdevelop.com/ja/2026/08/06/%e3%82%a4%e3%83%b3%e3%82%b9%e3%83%88%e3%83%bc%e3%83%ab/ https://www.foxdevelop.com/ja/2026/08/06/%e3%82%a4%e3%83%b3%e3%82%b9%e3%83%88%e3%83%bc%e3%83%ab/#respond Thu, 06 Aug 2026 07:51:04 +0000 https://www.foxdevelop.com/?p=7807 旧バージョンのインストール手順 ‐ CAS 5.0以前
  1. CASサーバーはJavaで開発されており、動作には2つのコア環境が必要です：
  • JDK（Java開発キット）：Java仮想マシン(JVM)を内蔵し、Javaプログラムを実行するための基礎環境です。
  • Tomcat（Webコンテナ）：CASのwar形式Webアプリケーションを配置・実行するために使用します。
  1. インストール手順のルール：先にJDKをインストール → 次にTomcatをインストール（Tomcatインストール時に自動的にローカルのJDK環境を探します）

依存環境

1. JDK

バージョン：（JDK）Java 17
直接リンク：Java Downloads | Oracle

⚠ 注意：JDK7は古いバージョンで、旧版CASにのみ対応。新規プロジェクトでの使用は推奨しません。

2. Apache Tomcat

バージョン：Tomcat（Windowsインストーラー版）
Apache Tomcat® – Welcome!

インストール手順

  1. JDKのインストール
    • exeインストーラーを実行、インストール先を任意に指定可能
    • 【重要】インストール完了後、環境変数 JAVA_HOME、Path の設定を推奨。TomcatがJava環境を正しく認識するために必要です
  2. Tomcat7のインストール
    • インストーラーを起動すると、既にインストール済みのJDKを自動で検出します
    • Tomcatのポート（初期値8080）、管理用アカウントとパスワードを任意設定可能
    • インストール終了画面のオプション：
    • Run Apache Tomcat：チェックを入れるとFinishクリック後にTomcatサービスが自動起動します
    • Show Readme：ドキュメントを参照しない場合はチェックを外して構いません
    • Finishをクリックしインストール完了

Tomcat SSL/HTTPS設定

前提：CASプロトコルはサーバー側でHTTPSの使用を強制しており、HTTPは利用できません。そのためTomcatにSSL証明書を設定する必要があります。

  1. JDK付属の keytool ツールを使いJKSキーストア（自己署名証明書）を作成
  2. Tomcatの conf/server.xml を編集し、SSLコネクタを有効化
  3. Tomcatを再起動し、https://localhost:8443 にアクセスしてHTTPS動作を確認

自己署名証明書(JKS)の作成

事前準備
  1. 証明書保存用フォルダを作成：例 C:\Keys
  2. 管理者権限でcmdを起動
    > Windows7/10/11 で通常のcmdからCドライブ直下へ書き込むと権限エラーが発生します。
  3. JDK/JREのbinディレクトリへ移動
cd "c:\Program Files\Java\jre\bin"

汎用コマンド（新しいJDKでも使用可）

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

パラメータ解説

パラメータ意味
-genkeyキーペアを生成
-alias tomcat証明書の別名、任意指定可
-keyalg RSA暗号化アルゴリズム、標準RSA
-storepass changeitキーストアパスワード（後のTomcat設定で使用するため必ず記録してください）
-keystore c:\Keys\.keystore証明書ファイル出力先
-validity 36000証明書有効期間（日数）
対話形式での情報入力

コマンド実行後、順番に情報を入力します：

  1. 名前：ドメイン名を入力（学習用途なら適当で可）
  2. 組織単位、組織名、都市、都道府県、国コード(cn)
  3. 情報確認で y を入力
  4. キーパスワード：そのままEnter、キーストアパスワードと同じにする
証明書確認コマンド
keytool -list -keystore "C:\Keys\.keystore"

パスワード入力後、正常に情報が出力されれば証明書作成完了です。

Tomcat server.xml SSLコネクタ設定

  1. Tomcat/conf/server.xml を開く
  2. コメントアウトされているSSL Connectorを探し、コメントを解除し証明書パスとパスワードを修正
<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" />
設定項目解説
  • port="8443"：Tomcat標準HTTPSポート（標準HTTPSは443、443に変更する場合はポート占有と権限に注意）
  • keystoreFile：作成した証明書ファイルのフルパス
  • keystorePass：keytoolで設定したキーストアのパスワード
  • clientAuth="false"：クライアント証明書不要（学習環境ではfalse固定）

動作確認方法

Tomcatを起動し、ブラウザからアクセス：
https://127.0.0.1:8443

自己署名証明書はブラウザで「安全ではない」と警告されますが正常な動作です。本番環境では正式なCA証明書を購入してください。

CAS 5.0以上のインストール

1、リソースの取得

CAS 5.0以降は従来の war + Tomcat 構成を廃止、SpringBootベースとなり単体実行Jarで外部Tomcat不要

  1. CASサーバー（Server）

CAS Initializr でデプロイパッケージをオンライン生成
https://casinitializr.apereo.org

2、CASサーバーデプロイ手順
  1. CAS Initializrを開く
  • CASバージョン選択：7.0.x（最新安定版）
  • 基本モジュールを選択：Core / Web / SSL
  • cas.war または単体実行用 cas.jar を生成・ダウンロード

2種類のパッケージ形式から選択：

  • モードA（推奨）：Standalone（単体Jar）、Tomcat内蔵ですぐ使用可能
  • モードB：従来のWarパッケージ、外部Tomcatへデプロイ（非推奨）
  1. 【単体Jarモード】でデプロイ（主流な手法）
    1）cas.jarをダウンロード
    2）設定フォルダ ./etc/cas/config を作成、cas.properties 設定ファイルを用意
    3）起動コマンド（Java17以上必須）
java -jar cas.jar
  1. ポートとHTTPSについて
    内蔵Tomcatのデフォルトポート：8443（HTTPS）
    新バージョンも旧バージョン同様、HTTPSが強制されます。
3、アクセス先
https://127.0.0.1:8443/cas

インストール

]]> https://www.foxdevelop.com/ja/2026/08/06/%e3%82%a4%e3%83%b3%e3%82%b9%e3%83%88%e3%83%bc%e3%83%ab/feed/ 0 紹介 https://www.foxdevelop.com/ja/2026/08/06/%e7%b4%b9%e4%bb%8b/ https://www.foxdevelop.com/ja/2026/08/06/%e7%b4%b9%e4%bb%8b/#respond Thu, 06 Aug 2026 07:35:57 +0000 https://www.foxdevelop.com/?p=7790 概念

1. CAS

CAS（Central Authentication Service、中央認証サービス）
イェール大学が開発したオープンソースのWeb SSO（シングルサインオン）実装フレームワークです。

2. SSO（シングルサインオン）

複数のWebシステムの本人確認を一つの拠点に集約して認証を行う仕組みです。

  • 特徴：各アプリケーションはHTTPSといったWebプロトコルで通信し、グローバルに唯一のログイン入口を持ちます
  • 平易な説明：同一ブラウザで認証センターに1回ログインすれば、信頼済みの各サイトへは再ログイン不要でアクセスできます

3. SSOシステムの3つの役割

  1. User：エンドユーザー（ブラウザ）
  2. Webアプリケーション（複数の業務システム）
  3. SSO認証センター（唯一）

4. SSOの3つの核心原則

  1. アカウントによるログイン処理はすべてSSO認証センターで実行する；
  2. 認証センターは各Webアプリケーションに対し、ユーザーが認証済みかどうかを通知する仕組みを提供する；
  3. 認証センターは全ての業務Webアプリケーションと事前に信頼関係を確立しておく。
二つの中核コンポーネント

CAS Server（認証サーバー側）

  • 独立してデプロイされるWebプログラム、唯一の認証拠点
  • 役割：ID・パスワードを受け取りユーザー認証を実施；チケット(Ticket)の発行、グローバルセッションCookie(TGC)の管理

CAS Client（各業務システムに埋め込むクライアント）

  • 各業務Webアプリケーション内部に配置、普通はFilterフィルターとして実装される
  • 役割：保護対象リソースへのリクエストを遮断；未ログイン時はブラウザをCAS Serverのログイン画面へ自動的にリダイレクト

処理フロー

  1. ユーザーが業務システムのリソースにアクセス → CAS Clientがリクエストを捕捉し、Service Ticketが存在しないことを検知
  2. ClientがブラウザをリダイレクトしCAS ServerのログインURLへ遷移、業務システムのアドレス(Service)を付与
  3. ユーザーはCASサーバー上でID・パスワードを入力しログイン認証を完了
    • ログイン成功：CAS ServerがブラウザへTGC（Ticket Granting Cookie）グローバルセッションCookieを書き込む
    • ワンタイムチケットService Ticket（ST）を生成
  4. CAS Serverが再度ブラウザをリダイレクト、業務システムURLへ戻りURLパラメータに Ticket=xxx を付加
  5. 業務システム側のCAS Clientがバックエンドからサーバー間リクエストを実行、ServiceアドレスとTicketを渡しCAS Serverにチケットの正当性を検証
  6. CAS Serverがチケット有効を確認し、ユーザー名などの本人情報を返却
  7. 検証合格、業務システムがローカルセッションを作成しユーザーがページを閲覧可能になる

TGCの役割：ブラウザにTGC Cookieが残っている限り、CAS連携済みの別システムにアクセスしてもログイン画面は表示されず、自動でシングルサインオンが実行されます。

紹介

]]> https://www.foxdevelop.com/ja/2026/08/06/%e7%b4%b9%e4%bb%8b/feed/ 0