# チームでCloudConsoleを使えるようにする

管理者向け：チームのアカウントとロールをまとめたセットアップリンクやQRコードを作り、普段は読み取り専用のロール、変更には別のロールを使う方法。

チームの複数のメンバーがCloudConsoleを使う場合は、スタートURL、アカウントID、ロール名の一覧の代わりに、1つの[セットアップリンクまたはQRコード](https://cloudconsole.dev/ja/help/setup-links)を渡しましょう。各メンバーはそれをスキャンするか開き、アクセスポータルごとに1回サインインを承認するだけで、同じアカウント、ロール、リージョンを使えます。リンクには秘密情報が含まれないので、社内wikiに載せておけます。

Screenshot: セットアップQRをスキャンしたあとにチームのメンバーに表示される画面

## 1. ~/.aws/configからリンクを作る

チームで使うプロファイルがAWS CLIの設定にすでにあるなら、無料の[AWS config to QRツール](https://cloudconsole.dev/ja/tools/aws-config-to-qr)に貼り付けます。ツールはブラウザの中で動作し、IAM Identity Centerのプロファイル（`sso-session`と古い形式の両方）とロールのプロファイル（`role_arn` + `source_profile`、`external_id`や連鎖を含む）を取り込み、見つかったキーは除外します。チームに不要なもののチェックを外してから、リンクをコピーするかQRコードを保存します。

## 2. 手作業で作る

セットアップリンクは、`https://cloudconsole.dev/connect#v1.`のあとにJSONのリストを続けたもので、raw deflateで圧縮し、パディングなしのbase64urlで表記します。リストの各項目はSSOアカウントかロールです。例：

```
[{"t":"sso","k":"prod","u":"https://acme.awsapps.com/start","sr":"eu-west-2",
  "a":"111122223333","n":"acme-prod","ro":"CloudConsoleReadOnly","r":"eu-west-2"},
 {"t":"role","k":"prod-operator","arn":"arn:aws:iam::111122223333:role/Operator",
  "src":"prod","x":"acme-oncall","r":"eu-west-2"}]
```

- **sso**：`u`（スタートURL）と`sr`（Identity Centerのリージョン）は必須です。`a`（アカウントID）と`ro`（ロール名）はセットで指定します。両方を省略すると、サインイン後に各自が選べます。`n`はアプリに表示されるアカウント名、`r`は開くリージョン、`k`はプロファイル名です。
- **role**：`arn`と`src`は必須です。`src`は別の項目の`k`か、その人のアプリにすでにあるアカウントの名前です。`x`は外部IDです。

このリストを入れたファイル`team.json`をリンクにするには：

```
python3 -c 'import json,sys,zlib,base64
d=json.dumps(json.load(open(sys.argv[1])),separators=(",",":")).encode()
c=zlib.compressobj(9,zlib.DEFLATED,-15); z=c.compress(d)+c.flush()
print("https://cloudconsole.dev/connect#v1."+base64.urlsafe_b64encode(z).decode().rstrip("="))' team.json
```

リンクをブラウザで開いて確認しましょう。[/connect (EN)](https://cloudconsole.dev/connect)ページに、追加される内容か、問題点が表示されます。各フィールドの値はキーやシークレットのように見えてはいけません。そう見える値があると、リンク全体が拒否されます。

## 3. 読み取り専用のロールと、変更用の別のロール

全員に、日々の確認用の読み取り専用ロールと、スマホから行ってよい変更のための別のロールを用意しましょう。

- **読み取り専用**：AWS管理ポリシー`ReadOnlyAccess`、または[推奨する権限](https://cloudconsole.dev/ja/help/recommended-permissions)にある、より絞り込んだCloudConsoleのポリシーを使ったIAM Identity Centerの許可セット。
- **変更用**：[変更に必要な権限](https://cloudconsole.dev/ja/help/permissions-for-changes)のうち、チームがオンコール中に使うべき操作だけを持つ2つ目の許可セット（または1つ目から引き受けるロール）。可能な範囲でリソースを絞り込み、タグの条件を追加しましょう。

両方をリンクに含めます。たとえば、読み取り専用ロールの`prod`と、変更用ロールの`prod-operator`です。変更用アカウントのガードレールを、アプリで**Typed + Face ID**に設定するようメンバーに依頼してください（[ガードレール](https://cloudconsole.dev/ja/help/guardrails)）。ガードレールや読み取り専用の設定は、リンクでは指定できません。

## 4. 共有する

リンクとQRコードを、アプリのインストール方法と並べてwikiやランブックに載せます。パソコンの画面に表示したQRコードは**Scan setup QR**で読み取れ、スマホではリンクをタップするだけです。1つのQRコードに入るのは約2,300文字なので、プロファイルが多い場合はリンクを共有するか、コードを2つに分けてください。

アプリから変更を行うには、変更を行う人それぞれにCloudConsole Proが必要です。1つのアカウントの閲覧は無料です。[無料版とPro](https://cloudconsole.dev/ja/help/free-and-pro)をご覧ください。

## よくある質問

### 共有のIAMユーザーのアクセスキーをリンクに含められますか？

いいえ。リンクに認証情報が含まれることはなく、キーやシークレットのように見えるものを含むリンクはアプリが拒否します。IAM Identity Centerを使うか、各自に自分のキーを追加してもらってください。

### リンクを変更するとどうなりますか？

古いリンクをすでに使ったスマホでは何も変わりません。メンバーは新しいリンクを開き、すでにあるもののチェックを外します。アカウントとロールが同じ項目は、重複せずに置き換えられます。

### リンクでガードレールや読み取り専用を設定できますか？

いいえ。それらは各スマホでアカウントごとに、Account → Accounts → 設定アイコンで設定します。

**解決しない場合**

試したことと、アプリに表示されたメッセージを添えて[support@cloudconsole.dev](mailto:support@cloudconsole.dev)までメールでお問い合わせください。アクセスキーやシークレットは送らないでください。2営業日以内にご返信します。

## 関連ページ

- [セットアップリンクやQRコードでアカウントを追加する](https://cloudconsole.dev/ja/help/setup-links) – AWSアカウントの接続
- [推奨する読み取り専用の権限](https://cloudconsole.dev/ja/help/recommended-permissions) – 権限とエラー
- [変更に必要な権限（Proの操作）](https://cloudconsole.dev/ja/help/permissions-for-changes) – 権限とエラー
- [ガードレール：変更を確認する仕組み](https://cloudconsole.dev/ja/help/guardrails) – 安全性と変更操作

[すべてのヘルプトピック →](https://cloudconsole.dev/ja/help/)

---

Source: https://cloudconsole.dev/ja/help/team-setup

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
