CreateEabCredential

Classic/VPC環境で利用できます。

ACMEクライアントとの連携に使用する External Account Binding(EAB)の認証情報を発行します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
POST	/api/v2/acme/account

リクエストヘッダ

Certificate Manager APIで共通して使用されるヘッダの詳細は、Certificate Managerのリクエストヘッダをご参照ください。

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`validationMode`	String	Required	検証モード `PRE` \| `DNS01`
`certificateTypeCode`	String	Required	証明書タイプ `NPD_01` \| `NPO_01`
`validityDays`	Integer	Required	証明書有効期間 (日)
`alias`	String	Required	ACMEアカウントのエイリアス
`organizationNo`	String	Conditional	組織番号 `certificateTypeCode`が`NPO_01`の場合、必ず入力

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://certificatemanager.apigw.ntruss.com/api/v2/acme/account' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--data '{
  "validationMode": "PRE",
  "certificateTypeCode": "NPD_01",
  "validityDays": 198,
  "alias": "my-acme-account"
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`returnCode`	String	-	レスポンスコード成功: `0`
`returnMessage`	String	-	レスポンスメッセージ
`totalRows`	Integer	-	照会されたリストの総数
`success`	Boolean	-	作成は成功したか
`message`	String	-	ビジネスメッセージ
`accountId`	Long	-	ACMEアカウント ID
`status`	String	-	アカウントの状態 `pending` \| `valid` `pending`: EABの発行後、ACMEサーバへの登録前 `valid`: ACMEサーバの登録完了
`eabKid`	String	-	EAB Key ID
`eabHmacKey`	String	-	EAB HMAC Key
`acmeDirectoryUrl`	String	-	ACMEディレクトリの URL
`eabExpireAt`	String	-	EABの有効期限 (ISO-8601形式)

レスポンスステータスコード

Certificate Manager APIで共通して使用されるレスポンスステータスコードの詳細は、Certificate Managerのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
  "returnCode": "0",
  "returnMessage": "SUCCESS",
  "totalRows": 0,
  "success": true,
  "message": "Account and EAB credentials created successfully",
  "accountId": 50123,
  "status": "pending",
  "eabKid": "eab_7f3c2af1b9",
  "eabHmacKey": "uQx2kJp3A8Yz....",
  "acmeDirectoryUrl": "https://ra-beta.example.com/acme/directory",
  "eabExpireAt": "2026-05-20T09:00:00"
}