Blank white background with no objects or features visible.

EMEAの皆様へ。TrueFoundryは、ヨーロッパ、中東、アフリカ全域で事業を拡大しています。詳細はこちら →

Kubernetes上のJupyter NotebooksへのOAuth2の追加

By スリハリ・ラダクリシュナ

Updated: 11月 3, 2026

Published: 7月 2, 2026

TrueFoundryユーザーは、AWS、Azure、GCPなどの個人クラウドアカウント上にJupyter Notebooksをデプロイできます。この機能により、自身のマシンで機械学習実験やトレーニングジョブを簡単に行うことができます。当初、TrueFoundryを通じてデプロイされたノートブックはユーザー名とパスワードの組み合わせで保護されていました。しかし、多くのクライアントからの要望に応えて、Single Sign-Onを統合しました。これにより、ユーザーはTrueFoundryで使用しているものと同じログイン情報でノートブックに便利にアクセスできるようになりました。このブログ投稿では、この機能をどのように実装したかについての詳細を掘り下げます。

TrueFoundryでのJupyter Notebookの起動

TrueFoundryにおけるNotebooks

TrueFoundryは内部的にKubeflow Notebook Controllerのフォークを使用して、ノートブックのデプロイをオーケストレーションしています。このコントローラーは、以下のような活用価値の高いさまざまな機能を提供します。

  1. 簡素化されたノートブックの仕様: Kubeflow Notebook APIはシンプルで、コントローラーがJupyter Notebookデプロイメントの作成をオーケストレーションします。
  2. 自動カリング (Automatic Culling): コントローラーは、一定期間非アクティブ状態が続いた後、ノートブックを自動的にシャットダウンします。これは、GPUマシンをバックエンドとするノートブックで実験を実行するクライアントにとって非常に便利です。
  3. 永続ホームディレクトリ: コントローラーは、セッションをまたいでノートブック上のユーザーの進行状況を保存する永続ボリュームの作成を処理します。
  4. 拡張可能なベースイメージ: コントローラーは、TrueFoundryがメンテナンスするJupyter NotebookおよびVS Codeのベースノートブックイメージのスイートをサポートしています。ユーザーは、スタートアップスクリプトを追加したり、特定のライブラリをインストールしたりすることで、これらのDockerイメージ上の機能を拡張できます。

参考として、シンプルなKubeflow Notebookオブジェクトの例を以下に示します。

apiVersion: kubeflow.org/v1
kind: Notebook
metadata:
 name: my-notebook
spec:
 template:
   spec:
     containers:
       - name: my-notebook
         image: kubeflownotebookswg/jupyter:master
         args:
           [
             "start.sh",
             "lab",
             "--LabApp.token=''",
             "--LabApp.allow_remote_access='True'",
             "--LabApp.allow_root='True'",
             "--LabApp.ip='*'",
             "--LabApp.base_url=/test/my-notebook/",
             "--port=8888",
             "--no-browser",
           ]

Notebooksのための基本認証 (Basic Auth)

OAuth2を実装する前、TrueFoundryは基本認証を統合することでパブリックノートブックのセキュリティを強化するオプションをユーザーに提供していました。この追加のセキュリティレイヤーは、権限を持つ個人だけがこれらのノートブックの機密コンテンツにアクセスできるようにするために極めて重要でした。この機能を実装するために、TrueFoundryはIstioプロキシ内のWebAssembly (Wasm) プラグイン(特にEnvoyプロキシ)の機能を活用しました。

オープンソースのサービスメッシュであるIstioは、さまざまなサービスワークロード間のネットワーク通信を管理するためのフレームワークを提供します。Istioを使用することで、TrueFoundryはEnvoyプロキシによって管理されるネットワークレイヤーにカスタムロジックを直接注入できるようになりました。このアプローチにより、Jupyter Notebooksに向かう/からのトラフィックを効果的に制御および保護することができました。基本認証の実装の鍵となったのは、Envoyプロキシ内でのWebAssemblyモジュールのデプロイを容易にするIstioの機能であるWasmPluginでした。

この基本認証WasmPluginは、Envoyプロキシ内のネットワークフィルターのシーケンスに統合されています。これらのフィルターにより、アクセス制御、変換、データ強化、監査などに関連する上位レベルの関数の実行が可能になり、サービスメッシュ全体のセキュリティと機能が強化されます。以下は、Envoyフィルターチェーンに基本認証フィルターを追加するための仕様の簡易バージョンです。

apiVersion: extensions.istio.io/v1alpha1
kind: WasmPlugin
metadata:
 name: basic-auth
 namespace: istio-ingress
spec:
 phase: AUTHN
 pluginConfig:
   basic_auth_rules:
     - credentials:
         - user:pass
       hosts: www.example.com
       prefix: /secret/
 selector:
   matchLabels:
     istio: ingressgateway
 url: oci://ghcr.io/istio-ecosystem/wasm-extensions/basic_auth:1.12.0

NotebookのためのOAuth2

ノートブックにOAuth2を実装するためにもEnvoyフィルターを使用しましたが、アプローチは基本認証のものとは異なりました。定義済みのWasmPluginをフィルターチェーンに便利に挿入できた基本認証とは異なり、OAuth2にはよりカスタマイズされたソリューションが必要でした。これを実現するために、OAuth専用に設計されたHTTPフィルターを採用しました。TrueFoundryでは、Single Sign-OnシステムがOAuthプロバイダーとして機能するFusionAuthと統合されています。

Envoy Filterの仕様は以下のようになります。詳細についてはファイル内のコメントを参照してください。

apiVersion: networking.istio.io/v1alpha3
kind: EnvoyFilter
metadata:
 name: truefoundry-notebook-tfy-oauth2  # Name of the EnvoyFilter
 namespace: auth-test  # Namespace where the EnvoyFilter is deployed
spec:
 workloadSelector:
   labels:
     truefoundry.com/application: truefoundry-notebook  # Selector targeting workloads with specific labels
 configPatches:
 - applyTo: CLUSTER
   match:
     context: SIDECAR_OUTBOUND
   patch:
     operation: ADD
     value:
       name: tfy-oauth2  # Name of the cluster for OAuth2 authentication service
       type: LOGICAL_DNS  # Type of service discovery (DNS)
       connect_timeout: 5s  # Timeout for establishing a connection
       lb_policy: ROUND_ROBIN  # Load balancing policy
       # other load balancing config
 - applyTo: HTTP_FILTER
   match:
     context: SIDECAR_INBOUND
     listener:
       filterChain:
         filter:
           name: "envoy.filters.network.http_connection_manager"
           subFilter:
             name: envoy.filters.http.jwt_authn
   patch:
     operation: INSERT_BEFORE  # Inserting this filter before the JWT auth filter
     value:
      name: envoy.filters.http.tfy-oauth  # Name of the OAuth filter
      typed_config:
        "@type": type.googleapis.com/envoy.extensions.filters.http.oauth2.v3.OAuth2
        config:
          use_refresh_token: false  # Whether to use a refresh token
          pass_through_matcher:
            - name: Authorization
              present_match: true  # Pass through if Authorization header is present
          forward_bearer_token: true  # Forward bearer token to upstream
          auth_type: BASIC_AUTH  # Type of authentication used
          token_endpoint:
            cluster: tfy-oauth2  # Cluster for token endpoint
            uri: <token-endpoint-uri-of-oauth-provider>
            timeout: 5s  # Timeout for token endpoint
          authorization_endpoint: <authorization-endpoint-uri-of-oauth-provider>
          redirect_uri: https://%REQ(:authority)%/truefoundry-notebook/_auth/callback  # Redirect URI for callback
          redirect_path_matcher:
            path:
              exact: /truefoundry-notebook/_auth/callback  # Path for redirect URI
          signout_path:
            path:
              exact: /truefoundry-notebook/_auth/signout  # Path for signout
          credentials:
            client_id: <client-id-for-oauth>
            token_secret:
               # configuration to fetch token secret
               # read more about how we fetch secrets here:
               # https://www.envoyproxy.io/docs/envoy/latest/configuration/security/secret
            hmac_secret:
               # configuration to fetch hmac

ユーザーがOAuth2フィルターで保護されたサービスに初めてアクセスしようとすると、authorization_endpointにリダイレクトされます。このエンドポイントは外部OAuthプロバイダーのURLであり、当社の実装ではFusionAuthベースのTrueFoundryログインモーダルになります。このリダイレクトはOAuthプロセスにおいて重要なステップであり、ユーザーを認証が行える安全な場所に案内し、その結果サービスへのアクセスに必要な権限を付与します。

ログインが完了すると、FusionAuthはredirect_uri(フィルター仕様で設定)にリダイレクトし、そこに秘密の一時的な認可コードを追加します。このリクエストはフィルターによってインターセプトされ、token_endpointにリクエストを送信して、コードをJWTトークンと交換します。最後に、フィルターはJWTトークンを含むクッキーを設定します。

クッキーがAuthorizationヘッダーに値としてJWTを設定するため、サービスへの以降のアクセスはHTTP Filterを通過します。フィルターはこのようなリクエストを通過させるように設定されています(仕様のpass_through_matcherを参照)。JWTが有効なトークンであることを検証するために、OAuthプロバイダーに確認を行うRequestAuthenticationポリシーを作成します。

apiVersion: security.istio.io/v1beta1
kind: RequestAuthentication
metadata:
 # ...
spec:
 selector:
   # ...
 jwtRules:
 - issuer: "truefoundry.com"
   fromHeaders:
   - name: Authorization
     prefix: "Bearer "
   audiences:
     - <client-id>
   jwksUri: <oauth-provider-jwks-uri>
   forwardOriginalToken: true

最後に、どのリクエストにRequestAuthenticationを適用するかを指定するAuthorization Policyを追加します。ポート8888上のすべてのリクエストに認可を適用します。

apiVersion: security.istio.io/v1beta1
kind: AuthorizationPolicy
metadata:
 name: best-notebook-tfy-oauth2
 namespace: auth-test
spec:
 selector:
   matchLabels:
     truefoundry.com/application: best-notebook
 action: DENY
 rules:
 - from:
   - source:
       notRequestPrincipals: ["*"]
   to:
     - operation:
         ports:
           - "8888"

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

11月 5, 2025
|
5 min read

エージェント型AI時代のデータレジデンシー:AIゲートウェイが実現する主権的スケールとコンプライアンス

10月 5, 2023
|
5 min read

<Webinar> 企業向け生成AIショーケース

Best Fine Tuning Tools for Model Training
5月 3, 2024
|
5 min read

2026年におけるモデル学習のためのファインチューニングツール トップ6

5月 25, 2023
|
5 min read

オープンソースLLM:受け入れるか、淘汰されるか

11月 18, 2026
|
5 min read

Claude Codeの制限について解説(2026年版)

No items found.
Analyzing how Cloudflare detects MCP traffic
11月 18, 2026
|
5 min read

How Cloudflare Detects MCP Traffic and Helps Secure It

No items found.
11月 18, 2026
|
5 min read

What Is AI Search? How It Works, Architecture, and Enterprise Use Cases

No items found.
Explaining LLM fine-tuning for enterprise AI teams
11月 18, 2026
|
5 min read

A Practical Guide to LLM Fine-Tuning: Methods, Data, Costs, and Deployment

No items found.
11月 3, 2026
|
5 min read

クラウドノードの自動プロビジョニングに関するガイド

Kubernetes

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour