<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="0" class="code-line">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
<p data-line="1" class="code-line">はじめまして、クラウドエース株式会社の金井です。<br>
新卒として、2024年4月にクラウドエースに入社しました。</p>
<p data-line="4" class="code-line">今回、初学者向け記事を書いてみようという社内企画として Google Cloud のサービスアカウントについて書かせていただきます。<br>
「サービスアカウントって何？」「何のためにあるの？」という疑問を解決できればと思います。</p>
<h2 id="%E3%81%9D%E3%82%82%E3%81%9D%E3%82%82%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%81%A8%E3%81%AF" data-line="7" class="code-line">
<a class="header-anchor-link" href="#%E3%81%9D%E3%82%82%E3%81%9D%E3%82%82%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%81%A8%E3%81%AF" aria-hidden="true"></a> そもそもサービスアカウントとは</h2>
<p data-line="8" class="code-line">まずは<a href="https://cloud.google.com/iam/docs/service-account-overview?hl=ja" target="_blank" rel="nofollow noopener noreferrer">公式ドキュメント</a>を読んでみましょう。</p>
<blockquote data-line="10" class="code-line">
<p data-line="10" class="code-line">サービス アカウントは、ユーザーではなく、アプリケーションや Compute Engine インスタンスなどのコンピューティング ワークロードで通常使用される特別なアカウントです。サービス アカウントは、アカウント固有のメールアドレスで識別されます。<br>
アプリケーションはサービス アカウントを使用して、認可された API 呼び出しを行います。これは、サービス アカウント自体として認証されるか、ドメイン全体の委任により Google Workspace または Cloud Identity ユーザーとして認証されます。アプリケーションがサービス アカウントとして認証されると、アプリケーションはサービス アカウントにアクセス権が付与されているすべてのリソースにアクセスできます。</p>
</blockquote>
<p data-line="13" class="code-line">なんだか難しい単語がたくさん出てきて混乱しそうですが、一つずつ見ていきます。</p>
<h3 id="%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88" data-line="14" class="code-line">
<a class="header-anchor-link" href="#%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88" aria-hidden="true"></a> サービスアカウント</h3>
<p data-line="15" class="code-line">サービスアカウントは通常のユーザーアカウント、つまり人間が使うアカウントではありません。<br>
誰が使うのかというとアプリケーションやCompute Engineインスタンスなどです。<br>
人間が使うアカウントであるユーザーアカウントと機械が使うアカウントを区別するためにサービスアカウントを用意しています。</p>
<p data-line="19" class="code-line">サービスアカウントの種類についても説明します。</p>
<table data-line="20" class="code-line">
<thead data-line="20" class="code-line">
<tr data-line="20" class="code-line">
<th></th>
<th>デフォルトの<br>サービスアカウント</th>
<th>ユーザー管理<br>サービスアカウント</th>
<th>Googleマネージド<br>サービスアカウント</th>
</tr>
</thead>
<tbody data-line="22" class="code-line">
<tr data-line="22" class="code-line">
<td>説明</td>
<td>自動的に作成されるサービスアカウント</td>
<td>プロジェクト内に利用者が自ら作成するサービス アカウント</td>
<td>Google Cloud サービスが使用するサービスアカウント</td>
</tr>
<tr data-line="23" class="code-line">
<td>デフォルトでIAMの<br>コンソールに表示</td>
<td>される</td>
<td>される</td>
<td>されない</td>
</tr>
</tbody>
</table>
<h3 id="api" data-line="28" class="code-line">
<a class="header-anchor-link" href="#api" aria-hidden="true"></a> API</h3>
<p data-line="29" class="code-line">サービスアカウントはアプリケーションに使われて何をしてくれるの？というとAPIの呼び出すための認証と認可を行っています。具体的には、サービスアカウントを使用してトークンを発行し、そのトークンを用いてAPIにアクセスすることで、アプリケーションが必要な操作を実行できるようにします。<br>
APIについて書くとそれだけで記事になってしまいますので、一言でいうと「アプリケーションやサービスが他のアプリケーションやサービスと通信し、機能やデータを利用するためのインターフェース」です。X(Twitter) やLINEなどで API を聞きなれている人も多いかと思います。要はサービスアカウントがあれば他のインスタンスやApp Engine アプリケーションの操作ができる、ということです。<br>
先ほど例に挙げた X(Twitter) では、 BOT アカウントの運用時などに使われたりします。</p>
<p data-line="33" class="code-line">Google Cloud においては API を利用する必要がある場合が非常に多いです。例えば Compute Engineの仮想マシン(VM) を利用する場合には「Compute Engine API」を有効にしなければいけません。</p>
<h2 id="%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%81%AE%E4%BD%9C%E3%82%8A%E6%96%B9" data-line="35" class="code-line">
<a class="header-anchor-link" href="#%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%81%AE%E4%BD%9C%E3%82%8A%E6%96%B9" aria-hidden="true"></a> サービスアカウントの作り方</h2>
<p data-line="36" class="code-line">では実際にサービスアカウントを作成してみましょう。<br>
今回は Google Cloud コンソールから作成する方法をご紹介します。</p>
<h3 id="%E4%B8%8B%E6%BA%96%E5%82%99" data-line="39" class="code-line">
<a class="header-anchor-link" href="#%E4%B8%8B%E6%BA%96%E5%82%99" aria-hidden="true"></a> 下準備</h3>
<p data-line="40" class="code-line">まずは Google Cloud コンソール画面にアクセスします。<br>
<img src="https://res.cloudinary.com/zenn/image/fetch/s--pGo8otMJ--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/72d75d0707d95c872661ac15.png%3Fsha%3D80fcc43f68d23cde77f907cf77e10dbb719675f6" alt="SA-01.png" loading="lazy" class="md-img"><br>
この画面の検索窓に今回作成したい「サービスアカウント」を入力すれば簡単に見つかります。早速コンソールから作ってみましょう。<br>
<img src="https://res.cloudinary.com/zenn/image/fetch/s--Ar-LVRXy--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/3a604611b39f6db2bfc29c35.png%3Fsha%3Dd6113239d97f7b8bbd34e0e00e59d3005e726e13" alt="SA-02.png" loading="lazy" class="md-img"><br>
<em>サービスアカウントの項目を選択</em></p>
<h3 id="%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E4%B8%80%E8%A6%A7" data-line="45" class="code-line">
<a class="header-anchor-link" href="#%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E4%B8%80%E8%A6%A7" aria-hidden="true"></a> サービスアカウント一覧</h3>
<p data-line="46" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s---FZXzst0--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/9b9b03577fe7de11ca32b50f.png%3Fsha%3D97f0e4a91ff719e53f47d8b7d93992df2946f6fb" alt="SA-03.png" loading="lazy" class="md-img"><br>
<em>VMインスタンスを作成したときに自動で作られているサービスアカウントが存在している</em><br>
作っていないはずのサービスアカウントが既に1つありますね。<br>
「サービスアカウントがあるので新規で作成する必要はないのでは？」<br>
と考えてしまいそうですがそうはいきません。公式ドキュメントによると</p>
<blockquote data-line="51" class="code-line">
<p data-line="51" class="code-line">デフォルトのサービス アカウント: 特定の Google Cloud サービスを有効にするときに自動的に作成される、ユーザー管理のサービス アカウント。これらのサービス アカウントは、ユーザーの責任で管理する必要があります。</p>
</blockquote>
<p data-line="53" class="code-line">という説明があります。ユーザーが管理すれば大丈夫、とはなかなかいかないようです。<br>
さらに、後述する権限の問題で、このデフォルトのサービスアカウントを使うことは推奨されていません。デフォルトのサービスアカウント以外を使うためにも作成してみましょう。</p>
<h3 id="%E6%96%B0%E8%A6%8F%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90" data-line="55" class="code-line">
<a class="header-anchor-link" href="#%E6%96%B0%E8%A6%8F%E3%82%B5%E3%83%BC%E3%83%93%E3%82%B9%E3%82%A2%E3%82%AB%E3%82%A6%E3%83%B3%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> 新規サービスアカウントの作成</h3>
<p data-line="56" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s--rsPtbWBN--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/bedff254a04d1a749e844451.png%3Fsha%3Dce57c55c192a8385c9b02190170569f0ed3d113e" alt="SA-04.png" loading="lazy" class="md-img"><br>
サービスアカウントの作成にはまず、「サービスアカウント名」「サービスアカウント ID」を決めます。サービスアカウント名は自身が見分けをつけるための表示名です。一方でサービスアカウント ID は1つしか存在しない ID です。今後はこの ID によってサービスアカウントを指定していきます。<br>
さて、次に進んでみましょう。</p>
<h3 id="%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E6%A8%A9(%E6%A8%A9%E9%99%90)%E4%BB%98%E4%B8%8E" data-line="59" class="code-line">
<a class="header-anchor-link" href="#%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E6%A8%A9(%E6%A8%A9%E9%99%90)%E4%BB%98%E4%B8%8E" aria-hidden="true"></a> アクセス権(権限)付与</h3>
<p data-line="60" class="code-line"><img src="https://res.cloudinary.com/zenn/image/fetch/s--NBdzn6oo--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/483244aeeea446816a93ab14.png%3Fsha%3D3da99d05a4e95ea4214ebf108ab234ec2f1ee57e" alt="SA-05.png" loading="lazy" class="md-img"><br>
ここではサービスアカウントへアクセス権を付与していきます。権限の中にはオーナーというものがあり、これをつければ完全アクセス権を与えられるので簡単に設定終了です...というわけにはいきません。<br>
<img src="https://res.cloudinary.com/zenn/image/fetch/s--k_iI0tnA--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/198dc15041d0b8e26ca3e13c.png%3Fsha%3D69f368922bb2b6dd9d26ec81b5a00e027e4a5360" alt="SA-06.png" loading="lazy" class="md-img"><br>
サイバーセキュリティの概念として、「最小権限の原則」というものがあります。これはユーザーが業務に必要な情報やシステムへの十分なネットワークアクセス(ユーザー権限)が与える必要があり、同時にそれ以上は与えてはいけないという原則となります。<br>
つまり「余計な権限をつけてはいけない」ということです。<br>
デフォルトのサービスアカウントを使わないことが推奨されているのも、アクセス権が編集者ロールが付与されているためです。<br>
そのくらいアクセス権というものには慎重になる必要があります。余計な権限を付与していると、不正アクセスを受けた場合、大きな被害をもたらす可能性があります。</p>
<p data-line="68" class="code-line">付与する権限には十分注意して、権限を付与していきましょう。<br>
最後にどのユーザーアカウントに、このサービスアカウントを使用してジョブと VM をデプロイする権限（サービスアカウントユーザーロール）とこのサービスアカウントを管理する権限（サービスアカウント管理者ロール）を付与するかを決めて、サービスアカウントの作成が完了します。お疲れさまでした。<br>
<img src="https://res.cloudinary.com/zenn/image/fetch/s--bfjQcCwW--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/6d1c164709f93608a49a8fd3.png%3Fsha%3Df549036169553a45d903b9a1eb5f6bf50c38dda6" alt="SA-07.png" loading="lazy" class="md-img"><br>
<em>省略可能ではありますが、設定しておくことを推奨</em><br>
<img src="https://res.cloudinary.com/zenn/image/fetch/s--Wupf0Ow9--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_1200/https://storage.googleapis.com/zenn-user-upload/deployed-images/ef647f3b3d2cf3e841ca6a76.png%3Fsha%3D943facf05c5d723e193f912d9c0f6ce19fb5f74a" alt="SA-08.png" loading="lazy" class="md-img"><br>
<em>新しいユーザー管理のサービスアカウントが作成された</em></p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81" data-line="74" class="code-line">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p data-line="75" class="code-line">サービスアカウントがどのようなものか、どのように作成するのかを説明しました。<br>
今回紹介したコンソール以外にも Google Cloud CLI を用いたコードでの作成も可能です。<br>
権限やアクセス許可など、難しい部分も多い内容ですが、初心者の皆さんの助けになれば幸いです。</p>


Google Cloud のサービスアカウントの役割とコンソールでの作成方法を解説

そもそもサービスアカウントとは

新規サービスアカウントの作成

googlecloud

beginner

Discussion