第１回(前回まで)
この記事では、LambdaからJira REST APIを安全に呼び出すための準備作業をまとめます。
この記事で書くこと（第2回）
- Jira CloudでAPI Tokenを発行する方法
- Secrets ManagerにJira認証情報を登録する
- IAMロールに必要な最小権限
- SNSトピックを作成し、後でCloudWatch / Step Functionsから通知する準備
- Lambdaの実行環境がどう Secrets / SNSと連携するかを理解する
1. 今回のゴール
以下、事前準備ができれば次の第３回でLambdaの最小実装 → 起票成功までできます。
| 準備項目 | 内容 |
|---|---|
| 1. Jira API Token 発行 | Lambda から Jira を呼び出すため |
| 2. Secrets Manager のセットアップ | Jira 認証情報を安全に保管 |
| 3. Lambda ロール（IAM）の作成 | SecretsManager:GetSecretValue を許可 |
| 4. SNS Topic の作成 | CloudWatch/StepFunctions が通知 |
2.Jira Cloud : API Tokenの発行
LambdaからJiraにHTTP APIを叩くには、API Token + Basic認証を利用する
手順
-
Jira Cloudにログイン後、アイコンからアカウント設定
-
セキュリティからAPI トークンの作成と管理
3.トークン作成から任意の名前を入力、表示されたトークンをコピー（再表示できないため注意）
これをLambdaのdeploy packegeに含めるのはNG
API TokenをLambda環境変数に入れるのも推奨されない。
漏洩リスクからSecrets Managerを利用する。
3. Secrets Managerのセットアップ
登録するJSON（テンプレ）
AWS Secrets Manager → 「新しいシークレットを作成」 → シークレットタイプキー/ バリューを登録
ポイント
| キー名 | 説明 |
|---|---|
| JIRA_BASE_URL | 企業ごとの Jira ドメイン |
| JIRA_EMAIL | API Token に紐付くユーザ |
| JIRA_API_TOKEN | ↑で発行した Token |
| JIRA_PROJECT_KEY | チケットの作成先プロジェクト |
| JIRA_ISSUE_TYPE | "Incident" / "Task" など |
シークレット名の命名例
jira/poc
jira/dev
jira/prod
今回はjira/devとしている
- IAM：Lambda実行ロールの作成
LambdaがSecrets Managerを読むための最小限のIAM権限を付与
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue"
],
"Resource": "arn:aws:secretsmanager:ap-northeast-1:<ACCOUNT_ID>:secret:jira/*"
},
{
"Effect": "Allow",
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents"
],
"Resource": "*"
}
]
}
ポイント
- Secrets ManagerのARNは必要に応じて厳格化
- LambdaからJiraへは外部アクセスなので別途VPCルールなどは不要
（デフォルト設定でインターネットに出られる）
5.SNS Topicの作成
トリガーとなるAWSリソースがエラーを発報した際にSNS Topicへ通知を送る
用のトピックを作成
6. curlでJira APIが動作することを確認
Lambdaを作る前に、APIが正常に動くかをローカルで先に確認
1. 環境変数のセット
# ➀ Jira サイト（ドメインのみ。https:// は付けない）
export JIRA_BASE_URL="XXXXX.atlassian.net"
# ➁ Atlassian アカウント（Jira にログインするときのメール）
export JIRA_EMAIL="<登録時のメールアドレス>"
# ➂ https://id.atlassian.com/manage-profile/security/api-tokens
# で発行した API トークン（Git等に絶対上げない）
export JIRA_API_TOKEN="(作ったAPIトークン)"
2. 疎通確認
# ➀ 認証付きで serverInfo を叩く
curl -s --http1.1 \
-u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
"https://$JIRA_BASE_URL/rest/api/3/serverInfo" \
| jq -r '.baseUrl'
→ サイトドメインが出力されること
# ➁ 課題作成（Issue 作成）の キーだけ 抜き出す
curl -s --http1.1 \
-u "$JIRA_EMAIL:$JIRA_API_TOKEN" \
-H "Content-Type: application/json" \
"https://$JIRA_BASE_URL/rest/api/3/issue" \
-d '{
"fields": {
"project": {"key": "OPS"},
"summary": "Test from curl",
"issuetype": {"name": "Incident"}
}
}' | jq -r '.key'
→ キーが返ってくること
➤参考（Curl結果 + Jira画面）
うまくいくとチケットが作成されている。
7. まとめ
この記事では、Lambda 実装に入る前の環境準備を整えました。
| 完了したこと | 理由 |
|---|---|
| ✔ Jira API Token 発行 | Jira REST API を叩くため |
| ✔ Secrets Manager 登録 | API Token を安全に保持 |
| ✔ IAM ロール作成 | Lambda が Secrets を取るため |
| ✔ SNS Topic 作成 | CloudWatch & StepFn 通知の受け口 |
次回（第3回）：最小のLambdaでJira起票成功まで
- urllib3を使ったHTTPリクエスト基礎
- Secrets Managerの読み取り
- 最小のJira Issue Create Lambda
- Test Eventで実際に起票してみる