【CP4DaaS】デプロイメント・ジョブの実行にタスク資格情報（APIキー）が必要になりました

# 1. はじめに
IBM Cloud Pak for Data as a Service（CP4DaaS）のデプロイメント・ジョブ実行時のセキュリティーを向上させるために、2024/8/15からデプロイメント・ジョブを作成する際にタスク資格情報（APIキー）が必要になりました。

:::note info
[配置スペースでジョブを実行するには、タスク認証情報が必要になりました](https://dataplatform.cloud.ibm.com/docs/content/wsj/getting-started/whats-new.html?context=cpdaas&audience=wdp#task-credentials-are-now-required-to-run-jobs-in-a-deployment-space)
:::

この記事ではタスク資格情報として使用できるユーザーAPIキーの作成方法や、デプロイメント・ジョブ作成時のユーザーAPIキーに関する内容について記載します。

（2024年9月時点の機能をもとに記載していますが、今後UIや仕様に変更が入る可能性がある点をご了承ください。）

# 2. ユーザーAPIキーの作成
ユーザーAPIキーを作成するには、CP4DaaSのWatson Studioにログイン後、画面右上のアバターをクリックし、「プロファイルと設定」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/747823dc-7426-b7fd-a834-755a02b6cf7f.png)

次に「ユーザーAPI鍵」タブをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/18e94cdf-d9cb-3cca-bd30-e66512a3d618.png)

「鍵を作成する」ボタンをクリックし、ユーザーAPIキーを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/c184c4e3-2f2b-d320-b703-10047c2f8fed.png)

作成されたユーザーAPIキーが一覧に表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/44249b1e-f0fd-197e-ec95-98a74c6fa324.png)

なおユーザーAPIキーはIBM Cloudの「管理」>「アクセス（IAM）」>「APIキー」からも確認できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/4fca42b5-4b48-58c1-3f83-581dfcddf39c.png)

# 3. ジョブの作成
ここではデプロイメント・スペースからジョブを作成する場合と、プロジェクトからジョブを作成する場合のそれぞれにおいて、ユーザーAPIキーが関連する設定画面について記載します。

## 3-1. デプロイメント・スペースからジョブ作成
デプロイメント・スペースからデプロイメント・ジョブを新規作成してみます。
作成済みのバッチ・デプロイメントを開き、「新規ジョブ」ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/b15d29ab-0639-821c-1259-837c1ddddeb7.png)

最初に表示される「詳細の定義」スクリーンに、タスク認証情報が必要な旨のメッセージが表示されます。
事前にユーザーAPIキーを作成している場合はこのままジョブの作成を進められますが、未作成の場合は先に上記の手順で作成しておきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/f7bc78d7-745f-d71d-13be-13bc2aed2a7a.png)

この後の画面ではユーザーAPIキーの設定項目は表示されないため、そのままジョブの作成を進めることが可能です。

## 3-2. プロジェクトからジョブ作成
次にWatson Studioのプロジェクトからジョブを新規作成してみます。
ここでは作成済みのSPSS Modelerフローからジョブを作成します。
SPSS Modelerフローのオーバーフロー・メニューから「新規ジョブ」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/bf3ae82d-f652-b806-0d21-da6f3480e8d4.png)

任意のジョブ名を入力し、「次へ」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/746f6153-a4c5-615a-96cd-5a107722acee.png)

「フロー・パラメーター」と「構成」を設定後、「スケジュール」の設定画面で「スケジュールで実行」にチェックを入れます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/9fb7ccbf-8bab-71ff-9133-de79594a03da.png)

すると以下のような画面が表示され、ジョブの実行にAPIキーが使用されることが分かります。
事前にAPIキーを作成済みのため、「API鍵のローテート」ボタンが表示されています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/f4beb505-389a-762f-66fa-83dfe336fb44.png)

APIキーが未作成の場合は以下のような「新規API鍵の作成」ボタンが表示されます。このボタンをクリックしてAPIキーを作成することが可能です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/64f79f1b-f606-8be6-3afa-7a6002924f4c.png)

APIキーが作成されると次の設定画面に進むことができ、ジョブを作成することができます。

# 4. APIキーのローテート
ユーザーAPIキーが作成済みであるとAPIキーの一覧に「回転」ボタンが表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/c76ffd34-6098-d4da-1e64-02c2411dfc80.png)
このボタンをクリックすると新しいユーザーAPIキーが作成され、これまでのユーザーAPIキーは「フェーズアウト」状況に変わります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/492427/b8e9dc07-24fc-d290-ed7c-142f940668e4.png)
なおローテート後のジョブ実行では新しいユーザーAPIキーが自動的に使用されるため、既存のジョブに対しAPIキーの再設定は不要です。

# 参考リンク
+ ユーザー API キーの管理
https://dataplatform.cloud.ibm.com/docs/content/wsj/admin/admin-apikeys.html?context=cpdaas
+ デプロイメント・スペースでのジョブの作成
https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/create-jobs.html?context=cpdaas
+ タスク資格情報の追加
https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/task-credentials.html?context=cpdaas

# おことわり
:::note warn
このサイトの掲載内容は私自身の見解であり、必ずしも所属会社の立場、戦略、意見を代表するものではありません。 記事は執筆時点の情報を元に書いているため、必ずしも最新情報であるとはかぎりません。 記事の内容の正確性には責任を負いません。自己責任で実行してください。
:::