機能ユーザー

機能ユーザーは、自動化されたタスクとシステムの間の統合を容易にするように設計された、非人的サービスアカウントです。標準ユーザーとは異なり、機能ユーザーは特定の個人または電子メールアドレスに関連付けられていないため、チームメンバーが組織を変更したり離れたりしても、自動化されたワークフローが中断されることはありません。

機能ユーザーの作成

セキュリティー上、Administrator のみが API を通じて、機能ユーザーを作成できます。

/api/v4/User/CreateFunctionalUser API エンドポイントを使用して、機能ユーザーを作成します。少なくとも次のパラメーターを組み込んでください。

FirstName: 説明的なアカウント名 (例:「Jira_Automation_Service」)。
RoleId: 機能ユーザーに割り当てるロール。次の API を使用して、RoleId を取得します。
```
api/v4/Roles
```

ヒント:

アクティブな電子メールアドレスはオプションですが、必要に応じて割り当てることができます。
ユーザーが Administrator ではない場合、ユーザーをアセットグループに関連付けます。これは後で追加できますが、ユーザーがアプリケーション関連コンテキストでタスクを実行することが重要です。
次の API を使用して、AssetGroupIds を取得します。
```
api/v4/AssetGroups
```

POST 要求が正常に完了すると、応答に API keyが含まれ、システムでは <FirstName>_Func_<OrgID> 形式で自動生成されたユーザー名を付けて、機能ユーザーが作成されます。

重要:

API key は 1 回だけ表示されます。すぐにコピーして、安全な場所 (シークレットマネージャなど) に保管します。UI には表示されず、後続の API 呼び出しからもアクセスできません。

UI での機能ユーザーの管理

API を使用して作成した機能ユーザーは、ユーザー管理 テーブルのすべてのユーザーの横にあるユーザー管理テーブルに表示され、標準ユーザーとして扱われます。使用可能なアクションについては、ユーザー管理ページを参照してください。

機能ユーザーのリストをフィルタリングするには、キーワード "func" を検索します。

API キーのローテーション

必要に応じて API キーをローテーションできます。

プロセス: ロールで許可されている場合は、API または UI を使用してキーのローテーションを実行します (「設定」 > 「API キー」の順に選択して自己割り当て)。
再認証: 新しいキーを生成するには再認証が必要です。機能 (サービス) ユーザーの場合、アクションはリンクされた管理者の資格情報を使用します。管理者は操作を再認証して確認しなければならない場合があります。
即時有効期限：新しいキーを生成すると、前のキーはすぐに期限切れになります。自動化スクリプトと統合をすぐに更新して、ダウンタイムを回避します。
ワンタイムビュー: 初期作成と同様に、新しいキーは API 応答で 1 回だけ返され、ローカルに保存する必要があります。