> For the complete documentation index, see [llms.txt](https://studio-docs.japan-ai.co.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.japan-ai.co.jp/guan-li-yun-yong/choose-personal-shared-connections-and-secrets.md).

# 個人接続・共有接続・Secretを選ぶ

外部サービスを使うProjectやAppでは、まず「誰の認証情報を、誰のために使うか」を決めます。選択を誤ると、利用開始や引き継ぎが難しくなります。

この記事では、個人接続・共有接続・Project Secret・Webログイン用シークレットを、認証情報の所有範囲から選ぶ考え方を説明します。設定手順は各管理記事を参照してください。

## 関連記事

* [Appの初期設定を完了する](/u/complete-app-setup.md)
* [Pageの仕様・制限](/shi-yang-zhi-xian/page-specs-and-limits.md)
* [自分の外部アカウントを接続する](/guan-li-yun-yong/connect-your-external-accounts.md)
* [Project・Appの共有接続を設定する](/guan-li-yun-yong/configure-shared-connections.md)
* [Project Secretを登録・更新・削除する](/guan-li-yun-yong/manage-project-secrets.md)
* [Webログイン用シークレットを管理する](/guan-li-yun-yong/manage-web-login-secrets.md)
* [実行モード・認証・対応範囲](/gaidobito/execution-modes-and-auth.md)

## この記事の範囲

ここで扱うのは、登録前の選び方です。外部サービス側の権限設定、実際の登録・更新・削除、Pageからの参照方法は扱いません。

表示や選択肢は、組織の設定、Project・Appの状態、利用者の権限で異なります。

> 接続できることと、その接続を業務で共有してよいことは別です。外部サービス側の利用規約、アカウントの権限、対象データ、費用、退職・異動時の引き継ぎ方法を確認してから、認証を完了してください。

## 最初に確認すること

本人か共通の業務アカウントか、必要なのは接続か秘密値か、誰が更新・停止するかを確認します。

本人の権限で扱うなら個人接続、共通の業務範囲なら共有接続を検討します。APIキー等はProject Secret、Webサイトのログイン情報はWebログイン用シークレットを確認します。

## 種類ごとの比較

利用可否は、Project・Appのアクセス権、外部サービス側の権限、設定の操作権限にも左右されます。接続またはSecretを置いただけで、全員が同じ操作を実行できるとは限りません。

| 種類              | 認証情報の所有範囲                         | 主に使える人            | 主な設定場所・画面表示                 | 所有者が異動・退職した場合に確認すること  | 典型的な用途           |
| --------------- | --------------------------------- | ----------------- | --------------------------- | --------------------- | ---------------- |
| 個人接続            | 本人の外部サービスアカウントで認証する接続です。          | 接続した本人            | 「個人のコネクタ」「個人用コネクタ」など        | 本人の利用継続、失効、後任者自身の接続要否 | 個人のメール、予定表など     |
| Project・App共有接続 | ProjectまたはAppの共通処理に使う接続です。        | 許可された利用者・処理       | 「プロジェクトのコネクタ」「アプリ共通のコネクタ」など | 認証アカウント、更新担当、依存するApp  | 部門共有の窓口、共通データ    |
| Project Secret  | Project単位で保持するAPIキーやトークンなどの秘密値です。 | 参照するよう設定された機能やApp | 「プロジェクトシークレット」              | 発行元、期限、更新担当、依存機能      | 外部APIキー、App用トークン |
| Webログイン用シークレット  | Webサイトへのログインに使用する秘密情報です。          | 設定された用途           | 「Webログイン用シークレット」            | アカウント継続、変更、後任の責任      | 承認済みWebサイトへのログイン |

> 個人の認証を共有用にコピーできる場合でも、チーム利用してよいとは限りません。外部サービス側の許可と管理責任者を確認してください。

## 選び方の目安

### 利用者本人の作業で、本人の権限を使う

個人接続を選びます。各担当者が自分の外部アカウントを使うAppでは、他の利用者も本人の認証が必要です。「接続が必要」と表示されたら、本人が認証後の状態を確認します。

個人の認証情報を他の人に使わせて代用しないでください。

### チームで同じ業務アカウント・同じ処理を使う

Project・App共有接続を検討します。共有業務アカウントで外部サービスに接続し、複数の利用者や共通処理が同じ範囲を扱う場合です。

作成後はAppへの設定結果と代表操作を確認します。

> 共有接続を選んでも、利用者に管理者権限が与えられるわけではありません。

### APIキーなどの値をProjectで使う

Project Secretを検討します。画面では「プロジェクトシークレット」と表示され、APIキーやトークンをProject単位で保存します。Appの要件がある場合は、作成後に正しいSecretを「紐づけ」ます。

値は一覧・詳細でマスクされます。名前と用途を確認し、検証用・本番用や別Projectの値を取り違えないでください。

> Secretの値をブラウザ側の変数、ログ、配布ファイル、問い合わせ資料に入れないでください。Pageからの参照は[Pageの仕様・制限](/shi-yang-zhi-xian/page-specs-and-limits.md)と[実行モード・認証・対応範囲](/gaidobito/execution-modes-and-auth.md)を確認します。

### Webサイトへのログイン情報を扱う

Webログイン用シークレットを確認します。Webサイトへのログイン用で、「プロジェクトシークレット」とは別種です。APIキーをProjectで使いたいだけなら登録しません。

MFA、IP制限、端末制限などがある場合は、対象機能の要件と管理責任者を確認します。

## 引き継ぎ時の確認

異動、退職、管理者変更、パスワード・APIキーの更新時は、依存するProject・App・機能、停止・更新日時、後任者、変更後の代表操作を確認します。

設定名、対象、用途、管理担当、更新期限は記録し、実値は記録しません。

## よくある誤解

### 管理者が一度接続すれば、全利用者が使える

個人接続が必要なAppでは、利用者ごとに本人の認証が必要です。共通接続が必要な場合は、個人接続だけでは要件を満たしません。「個人用のコネクタ」「アプリ共通のコネクタ」と状態を確認してください。

### 接続とSecretは同じ設定である

接続は外部サービスとの認証・連携、Project Secretは秘密値の保存です。Webログイン用シークレットも別種です。必要なのが接続、APIキー等、Webログイン情報のどれかを先に分けます。

### Secretを作成した人がいなくなると、必ずすぐ使えなくなる

作成者の変更だけでは動作を判断できません。依存先、有効性、変更権限を確認し、必要なら新しい担当者が更新して動作確認します。削除すると一部の機能が実行時エラーになる可能性があります。

### Webログイン用シークレットをAPIキーの保管場所として使える

Webログイン用シークレットはWebサイトへのログイン用です。Projectで使うAPIキーやトークンは、「プロジェクトシークレット」を確認します。用途が分からない場合は、値を登録せず、対象App・機能の案内と管理担当者へ確認してください。

## 確認できない場合

「コネクタ」や「シークレット管理」が表示されない、設定後も「未設定」「確認中」「無効」と表示される場合は、設定不要と判断しないでください。対象、権限、外部サービス側のアカウント状態を確認します。

問い合わせには対象、設定種類、表示内容、操作日時を添え、Secretの値やパスワードは送らないでください。

## 次に読む記事

* [自分の外部アカウントを接続する](/guan-li-yun-yong/connect-your-external-accounts.md)
* [Project・Appの共有接続を設定する](/guan-li-yun-yong/configure-shared-connections.md)
* [Project Secretを登録・更新・削除する](/guan-li-yun-yong/manage-project-secrets.md)
* [Webログイン用シークレットを管理する](/guan-li-yun-yong/manage-web-login-secrets.md)
* [実行モード・認証・対応範囲](/gaidobito/execution-modes-and-auth.md)
* [Appの初期設定を完了する](/u/complete-app-setup.md)
