ドキュメント

Adobe Commerceの無効なPEM形式トリガーキー検証エラー

Last update: Mon Mar 30 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Adobe Commerceでは、Commerce Services ConnectorでAdobe Payment ServicesのAPI キーを設定する際に、キー検証エラーが発生します。 これらのエラーは、秘密キーのPEM （Privacy-Enhanced Mail）ファイルが正しくフォーマットされていない場合に表示されます。 この問題を修正するには、Base64 コンテンツがヘッダーとフッターから適切に分離されるように、PEM （Privacy-Enhanced Mail）ファイル形式を修正します。

説明 description

環境

商品：Adobe Commerce

問題/症状

セットアップ中に次の現象が発生します。

  • サンドボックスキーを追加する際に、「公開キーが無効です」、「秘密キーが無効です」というエラーメッセージが表示される。
  • PEM形式が正しくないため、秘密鍵の検証が失敗します。キーコンテンツは、ヘッダーまたはフッターと同じ行に配置されています。

解決策 resolution

この問題を修正するには、次の手順に従います。

  1. 秘密鍵PEM ファイルのヘッダーとフッターの間の別々の行に、余分な文字や先頭スペースなしでBase64 コンテンツが含まれていることを確認します。 詳しくは、Commerce Services Connectorを参照してください。

  2. 追加の文字または先頭スペースがある場合は、以下のサンドボックス秘密鍵を使用してサンドボックスを正規化できます。

    code language-none 
    awk '
function trim(s){ sub(/[  \t\r\n] +/, "", s); sub(/[  \t\r\n] +$/, "", s); return s }

# BEGIN/END lines: print as-is (trimmed), no extra newlines
/-----BEGIN / { print trim($0); next }
/-----END /   { print trim($0); next }

# Body: remove *all* whitespace then wrap at 64 chars
{
  line = trim($0)
  gsub(/[  \t\r\n] /, "", line)
  while (length(line) > 64) { print substr(line,1,64); line = substr(line,65) }
  if (length(line)) print line
}' <key_incorrect_oneline.pem> > <key_normalized_multiline.pem>

  3. 修正されたサンドボックス秘密鍵をCommerce サービスコネクタ設定に入力します。 詳しくは、Commerce Services Connectorを参照してください。

  4. 成功した場合は、正規化された実稼動秘密鍵で繰り返します。

  5. Commerce Services Connector ページを更新します。

  6. コネクタインターフェイスの公開鍵と秘密鍵の両方を再検証します。

  7. それ以上の無効なキーエラーが表示されないことを確認します。

メモ

  • サンドボックスと実稼動環境の両方の公開鍵は変更を必要としません。
  • 正規化されたPEM ファイルは、標準のPEM フォーマット要件（1行あたり64文字でラップされたBase64 データ）に従って提供または生成された形式で使用する必要があります。

関連トピックス

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f