2.12 SSL購読情報の置換
2.12.1 API情報
| テスト環境 | |
|---|---|
| 本番環境 | https://portal.racent.com/ssl/replace |
| リクエストメソッド | POST |
| content-type | multipart/form-data |
| 説明 | このインターフェースはSSL購読情報の置き換えに使用されます。SSL証明書関連のみ対象です。SSL購読ステータスが発行済みの場合に限り、SSL購読情報の置き換えが許可されます。 |
2.12.2 パラメータ定義
| パラメータ名 | パラメータタイプ | 必須 | 説明 |
|---|---|---|---|
| api_token | String | Y | 認証情報です。tokenの生成についてはRacentテクニカルサポートまでお問い合わせください。 |
| certId | String | Y | racent証明書id |
| refId | String | N | お客様から提供される一意の受注番号 |
| domainVerificationPic | File | N | ドメイン検証方式がVERIFY_DOCUMENTの場合、この項目は必須（Y）です。ドメイン管理権限の検証（DCV）に使用されます（現在はCFCAのみ対応）。 |
| params | String | Y | 置換情報であり、詳細は以下の通りです |
| csr | String | Y | 注：CSR情報内のドメインは、元のSSL購読のCSRに含まれるドメインと一致している必要があります。 |
| uniqueValue | String | N | Sectigo製品のみに関連します。販売店が独自に検証値を生成するための1～20文字（a-z A-Z 0-9）の文字列です。 |
| dcvMethod | String | N | 申請ドメインの検証方式を一括設定します。 以下の4つの方式のいずれかを指定する必要があります： EMAIL（メール検証） HTTP_CSR_HASH（ファイル検証） CNAME_CSR_HASH（DNS検証） HTTPS_CSR_HASH（HTTPSファイル検証） VERIFY_DOCUMENT（ドメイン証明書による証明、CFCAのみ対応） CFCAの場合はこの項目が必須（Y）です |
| domainInfo | String | Y | ドメイン情報。 例： [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] 詳細は以下の説明をご参照ください。 |
| dcvMethod | String | Y | ドメイン検証方式。 以下の4つの方式のいずれかを指定する必要があります： EMAIL(メール検証) HTTP_CSR_HASH(ファイル検証) CNAME_CSR_HASH(DNS検証) HTTPS_CSR_HASH(httpsファイル検証) 上位のdcvMethodが存在しない場合、この項目は必須（Y）です。 上位のdcvMethodが存在し、この項目も指定されている場合は、上位のdcvMethodが優先的に使用されます。 |
| dcvEmail | String | N | ドメイン検証用メールアドレス。 この項目がN（任意）の場合のデフォルト値は以下の通りです racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
| domainName | String | Y | ドメイン名 |
| organizationInfo | String | N | 企業情報を変更する必要がある場合、このパラメータは必須（Y）となります。 |
| organizationCity | String | N | 会社の所在都市。 |
| organizationName | String | N | 会社名。 |
| organizationMobile | String | N | 会社の電話番号。 |
| organizationAddress | String | N | 会社の住所。 |
| organizationCountry | String | N | 会社の所在国（ISO 3166-1規格の2文字コード）。 |
| organizationPostCode | String | N | 会社所在地の郵便番号。 |
関数の戻り値
| パラメータ名 | パラメータタイプ | 必須 | 説明 |
|---|---|---|---|
| code | Int | Y | 返却ステータス。詳細は付録3.1を参照してください |
| errors | Object or String | N | 返却ステータスがエラーの場合の具体的なエラー情報 |
| data | Object | N | 返却ステータスが成功の場合、このパラメータはYとなります。具体的な説明は以下の通りです： |
| certId | String | N | Racent証明書ID。Racentインスタンスの一意の認証情報となるため、大切に保管してください。 |
| vendorId | String | N | CA注文番号 |
| vendorCertId | String | N | CA証明書番号 |
| DCVfileName | String | N | ファイル検証用ファイル名 |
| DCVfileContent | String | N | ファイル検証用ファイルの内容 |
| DCVdnsHost | String | N | DNS検証ホスト値 |
| DCVdnsValue | String | N | DNS検証レコード値 |
| DCVdnsType | String | N | DNS検証レコードタイプ |
| DCVfilePath | String | N | ファイル検証用ファイルのパス |
| dcvInfo | Object | N | 証明書申請に含まれる各ドメインの検証値が異なる場合、この項目はYとなります 各項目の型はObjectで、項目名は申請するドメイン名（例:racent.com）です。各項目の詳細は以下の通りです： |
| DCVfileName | String | N | ファイル検証用ファイル名 |
| DCVfileContent | String | N | ファイル検証用ファイルの内容 |
| DCVdnsHost | String | N | DNS検証のホスト値 |
| DCVdnsValue | String | N | DNS検証のレコード値 |
| DCVdnsType | String | N | DNS検証のレコードタイプ |
| DCVfilePath | String | N | ファイル検証用ファイルのパス |