# SSO ログイン

1 つの認証情報で、すべてのプラットフォームに対応します。Treasure AI Studio は既存の Treasure AI アカウントで認証を行うため、管理すべき API キーも、組織の SSO 以外に覚えるパスワードもありません。サインインのフローはプラットフォームによって少し異なり、Web は URL からリージョンが決まる一方、Desktop と Mobile ではリージョンを選択します。このページでは 3 つすべてのフローと、セッションが更新される仕組み、正しくサインアウトする方法を説明します。

Studio がパスワードを参照することはありません
Treasure AI Studio は、OAuth 2.0 Authorization Code フローと PKCE を使用し、Treasure AI 経由で組織の ID プロバイダーへフェデレーションしてサインインします。認証情報は ID プロバイダーに送られ、Studio に渡ることはありません。認可コードがブラウザの URL に露出することもありません。

## 目的

お使いのプラットフォームで Treasure AI Studio にサインインし、再度の入力を求められずに更新されるセッションを確立します。

## 前提条件

- SSO アクセスが有効な **Treasure AI アカウント**
- **アカウントのリージョン**（US01、AP01、EU01、AP02 のいずれか。Desktop と Mobile では必須です。Web は URL から判定します）


## サポートされているリージョン

Treasure AI Studio は 4 つの本番リージョンで稼働しています。それぞれが独立したデプロイであり、お客様のアカウントはそのうち 1 つに存在します。

| リージョン  | 表示 | AWS リージョン |
|  --- | --- | --- |
| **US01** | US01 - アメリカ合衆国 | us-east-1（バージニア北部） |
| **AP01** | AP01 - 日本 | ap-northeast-1（東京） |
| **EU01** | EU01 - ヨーロッパ | eu-central-1（フランクフルト） |
| **AP02** | AP02 - 韓国 | ap-northeast-2（ソウル） |


リージョンは、Studio のデータが保存される場所と、プロンプトを処理する地理的範囲を決定します。[リージョンごとの LLM データレジデンシー](/ja/products/ai-studio/security#%E3%83%AA%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%81%94%E3%81%A8%E3%81%AE-llm-%E3%83%87%E3%83%BC%E3%82%BF%E3%83%AC%E3%82%B8%E3%83%87%E3%83%B3%E3%82%B7%E3%83%BC)を参照してください。サインイン中のセッションのリージョンを確認するには、**設定 → プロフィール**を開き、**環境**の値（例：`production-us01`）を確認します。

お使いのリージョンが表示されない場合
サインイン画面に表示されるのは、Treasure AI Studio が稼働しているリージョンのみです。お客様のアカウントのリージョンが表示されない場合は、担当のカスタマーサクセスマネージャーにお問い合わせください。

## Web

Web では、開いた URL がリージョンを決定します。リージョンごとに専用の Studio アドレスがあるため、リージョンの選択画面はありません。

1. 組織の Treasure AI Studio の URL を開きます。
2. サインイン画面に Treasure AI Studio のロゴ、見出し「Treasure AI Studio へようこそ」、そしてボタンが 1 つ表示されます。
3. **[Treasure Dataでサインイン]** をクリックします。
4. 同じブラウザタブで Treasure AI のサインインページが開きます。認証情報を入力するか、組織の ID プロバイダーのフローを完了します。
5. 認証が完了するとブラウザが Studio に戻ります。セッションの確立中に「サインイン中…」が短時間表示され、その後 Studio のランディングページが読み込まれます。


Web にリージョン選択がない理由
各リージョンは専用のホスト名で提供されるため、URL を開いた時点でリージョンの選択が完了しています。Web で別のリージョンにサインインするには、そのリージョンの URL を開いてください。アプリ内で切り替える操作はありません。

## Desktop（macOS / Windows）

Desktop アプリはすべての本番リージョンに接続できるため、サインイン前にリージョンの選択を求めます。

1. **Treasure AI Studio** を起動します（macOS ではアプリケーションから、Windows ではスタートメニューから）。
2. ウェルカム画面に見出し「Treasure AI Studio へようこそ」とサブタイトル「サインインするリージョンを選択してください」が表示されます。
3. **リージョン**を選択します。各行はラベルと説明が付いたラジオボタンです（例：「**US01** - アメリカ合衆国」）。
4. **[Treasure Dataでサインイン]** をクリックします。
5. 既定のシステムブラウザで Treasure AI のサインインページが開きます。認証情報を入力して認証を完了します。
6. ブラウザが自動的に Desktop アプリへ制御を戻します。「サインイン中…」の画面が短時間表示され、その後 Studio が使用可能になります。


最初のリージョンが選択済みです。自分のリージョンでなければ変更してください
リージョンの選択画面は最初のリージョンが選択済みの状態で表示され、**[Treasure Dataでサインイン]** は最初から有効です。クリックする前に、選択されている行が自分のリージョンであることを確認してください。そうでない場合、アカウントが存在しない別のリージョンのサインインページへ送られます。

ブラウザからセッションが戻る仕組み
Desktop アプリは OAuth のコールバック用にカスタム URL スキームを登録します。ブラウザで認証が完了すると、認可コードがそのスキーム経由でアプリへ戻り、PKCE を使ってトークンと交換されます。アプリはそのトークンを OS のキーストア（macOS では Keychain、Windows では DPAPI）で暗号化して保存します。平文で保存することはありません。

**ブラウザからアプリに戻らない場合:**

- 認証を完了する時点で Treasure AI Studio が起動したままであることを確認してください。
- アプリを終了して再起動し、もう一度サインインしてください。
- アプリがカスタム URL スキームのハンドラーとして登録されている必要があります。ほとんどの場合、再インストールで登録が復旧します。


## Mobile

1. iPhone、iPad、または Android デバイスで **Treasure AI Studio** を開きます。初回起動時には**データの利用について**の画面が表示されるので、**続ける**をタップします。
2. ウェルカム画面に「Treasure AI Studio へようこそ」とサブタイトル「サインインするリージョンを選択してください」が表示されます。
3. アカウントのリージョンをタップします。各項目にはラベルと説明が付いたラジオボタンが表示されます（例：「**US01** - アメリカ合衆国」）。最初のリージョンが選択済みの状態なので、タップした行が自分のリージョンであることを確認してください。
4. **[Treasure Dataでサインイン]** をタップします。
5. セキュアなサインイン用ブラウザで Treasure AI のサインインページが開きます。認証情報を入力して認証を完了します。
6. ブラウザが閉じ、セッションの確立中に「読み込み中...」のインジケーターが短時間表示されます。
7. 初回サインイン時は**利用規約**を確認し、**同意する**をタップします。新規チャットの入力欄が表示されます。


Mobile で 2 回サインインすることがほとんどない理由
Mobile アプリはリフレッシュトークンをデバイスのセキュアストレージ（iOS では iOS Keychain、Android では Keystore に基づく Android のセキュアストレージ）に保存します。次回以降の起動ではサイレントにセッションを更新するため、リフレッシュトークンが失効するかサインアウトするまでサインインしたままになります。

**トラブルシューティング:**

- **サインインページが読み込まれない** — ネットワーク接続を確認し、アカウントに対して正しいリージョンを選択しているか確認してください。
- **一定時間操作しないとサインイン画面が表示される** — もう一度 **[Treasure Dataでサインイン]** をタップしてください。アプリはまずサイレントな更新を試みます。


## セッションの管理

| 項目  | 挙動 |
|  --- | --- |
| **トークンの保存先** | **Web:** ID SDK が管理するブラウザのセッション。**Desktop:** OS のキーストア（macOS Keychain、Windows DPAPI）で暗号化されたローカルのトークン。**Mobile:** デバイスのセキュアストレージ（iOS では iOS Keychain、Android では Keystore に基づくセキュアストレージ）。 |
| **トークンの更新** | 自動。有効期限前に更新され、入力を求められることはありません。 |
| **複数デバイス** | Web、Desktop、Mobile に同時にサインインできます。 |
| **複数アカウント** | 1 セッションにつき 1 アカウントです。別のアカウントやリージョンを使うには、先にサインアウトしてください（Desktop と Mobile）。Web では別リージョンの URL を開きます。 |
| **サインアウト** | **Web / Desktop:** 設定 → プロフィール → **[サインアウト]**。**Mobile:** 設定シート → **サインアウト**。 |


サインインの認証情報とデータアクセスの認証情報は別物です
サインインは Studio の*セッション*を確立します。それとは別に、Studio はエージェントがデータ操作に使う Treasure AI の認証情報を保持しており、その認証情報はエージェントのサンドボックス内に置かれることがありません。[認証情報はサンドボックスに入らない](/ja/products/ai-studio/security#%E8%AA%8D%E8%A8%BC%E6%83%85%E5%A0%B1%E3%81%AF%E3%82%B5%E3%83%B3%E3%83%89%E3%83%9C%E3%83%83%E3%82%AF%E3%82%B9%E3%81%AB%E5%85%A5%E3%82%89%E3%81%AA%E3%81%84)を参照してください。

## サインアウトする

### Web / Desktop

1. サイドバーのフッターにあるユーザーアバターをクリックして**設定**を開きます。
2. 左側のナビゲーションで、**ユーザー**配下の**プロフィール**をクリックします。
3. **[サインアウト]** をクリックします。


### Mobile

1. ナビゲーション ドロワーを開き、左下のアバターをタップして設定シートを開きます。
2. プロフィール カードの下にある **サインアウト** をタップします。
3. 「サインアウト」ダイアログで **確認** をタップします。


サインアウトするとローカルのセッションがクリアされ、ローカルの状態がリセットされます。チャット履歴、ファイル、作業フォルダの設定はサーバー側に残り、次回サインイン時に利用できます（組織の[チャットデータ保持](/ja/products/ai-studio/security/data-retention)期間の範囲内）。

## エージェントが使う Treasure AI 認証情報をリセットする

**設定 → プロフィール**には **[TD認証情報を無効化]** もあります。これは Studio からサインアウトせずに、エージェントがデータ操作に使う Treasure AI の認証情報を削除します。次にエージェントが Treasure AI へのアクセスを必要としたときに、あらためて認可を求められます。

誤った Treasure AI アカウントで認可してしまった場合や、権限の変更後に再認可を強制したい場合に使用します。

無効化とサインアウトは別の操作です
**[TD認証情報を無効化]** はデータアクセス用の認証情報のみを消去し、Studio のセッションは継続します。**[サインアウト]** はセッションを終了しますが、保存されたデータアクセス用の認証情報は次回サインインのために残ります。デバイスを他の人に渡す場合はサインアウトしてください。

## 確認事項

- [ ] Studio のランディングページに「Let's build something」というタイトルが表示される
- [ ] サイドバーのフッター（Web / Desktop）または設定シート（Mobile）にメールアドレスが表示される
- [ ] **設定 → プロフィール**の**環境**の値が、お使いのリージョンとして想定したものになっている
- [ ] テストメッセージを送るとエージェントから応答がある


## トラブルシューティング

| 問題  | 解決策 |
|  --- | --- |
| サインイン後に空白のページにリダイレクトされる | 正しいリージョンを選択しているか（Desktop / Mobile）、正しいリージョンの URL を開いているか（Web）を確認してください。ブラウザのキャッシュをクリアするか、アプリを再起動して再試行してください。 |
| 「Authentication failed」と表示される | Treasure AI の認証情報が有効で、組織で Treasure AI Studio が有効化されていることを確認してください。解決しない場合は管理者にお問い合わせください。 |
| セッションが予期せず切れる | 一定時間操作がないとセッションは終了します。もう一度サインインしてください。チャット履歴はサーバー側に保持されています。 |
| 特定のネットワークからのみサインインに失敗する | ID プロバイダーがサインインを開始できるネットワークを制限している可能性があります。[アクセス制御](/ja/products/ai-studio/security/access-control)を参照してください。 |
| 誤った Treasure AI アカウントでサインインしてしまった | **設定 → プロフィール**の **[TD認証情報を無効化]** で保存されたデータアクセス用の認証情報を消去し、あらためて認可してください。 |


## 次のステップ

- [アクセス制御](/ja/products/ai-studio/security/access-control) — 権限と IP ポリシーが Studio にどう適用されるか
- [セキュリティ概要](/ja/products/ai-studio/security) — サンドボックスの分離、暗号化、データレジデンシー
- [はじめに](/ja/products/ai-studio/getting-started) — プラットフォームごとの Studio のインストールとセットアップ
- [設定](/ja/products/ai-studio/settings) — 個人設定と組織設定