本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>ニフクラAPI>シグネチャーについて
本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/api/signature.htmへ移行しました。 今後は新ページをご参照ください。

シグネチャーについて

ニフクラではシグネチャー(署名文字列)を使用して認証を行います。
APIを使用する際のリクエストには、シグネチャーを付与する必要があります。

サポートしているシグネチャーバージョン

シグネチャーバージョン2〜4があり、機能ごとに対応バージョンが異なります。

機能 対応バージョン
ニフクラ(コンピューティング) 2
オブジェクトストレージサービス 4
NAS 2/4
RDB 2/4
DNS 3
ESS(メール配信) 3/4
スクリプト 4
Kubernetes Service Hatoba 4
DevOps with GitLab 4
サービスアクティビティ 4

シグネチャー生成方法

シグネチャーバージョン 2

ニフクラコンピューティングAPIの共通パラメーターと認証方式をご覧ください。

コンピューティング:共通パラメーターと認証方式

シグネチャーバージョン 3

ニフクラ DNS及びESS(メール配信)をご利用の場合は、下記の方法で生成してください。

  1. リクエストの特定情報に基づいた文字列を作成します。身元証明のための最初の手順として、文字列を作成します。

    この文字列の作成方法は、リクエストのdate headerを、UTF-8エンコード(例:Thu, 19 Nov 2009 19:37:58 GMT)するだけです。

    リクエストは、Date header、X-Nifty-Date headerを含めるか、両方を含める必要があります。
    両方含めた場合は、ニフクラ側でdate headerが無視されます。

    ヘッダー値の形式はタイムスタンプとして定められた以下フォーマットのどれかでなければなりません。

    Sun, 10 Nov 2013 08:49:37 GMT (RFC 822, updated by RFC 1123)
    Sunday, 10-Nov-13 08:49:37 GMT (RFC 850, obsoleted by RFC 1036)
    Sun Nov 10 08:49:37 2013 (ANSI C's asctime() format)  
  2. シグネチャーを算出します。
    1. Secret Access Key と手順(1)で作成した文字列を使用してシグネチャーを生成します。
      この時のアルゴリズムは、HmacSHA1またはHmacSHA256を使用します。
    2. 算出結果をbase64エンコード変換します。
      date header String

      Sun, 10 Nov 2013 17:08:48 GMT

      Secret Access Key

      wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

      エンコード化したシグネチャー

      4cP0hCJsdCxTJ1jPXo7+EXAMPLE=
  3. リクエストにシグネチャーを含め、HTTPSを使用してリクエストをニフクラに送信します。
    (HTTP通信は受け入れられません。)
    X-Nifty-Authorization headerの一部としてシグネチャーを含めます。
    シグネチャーとAccess Key IDの両方を含める必要があります。

    NIFTY3-HTTPS NiftyAccessKeyId=MyAccessKey,Algorithm=ALGORITHM,Signature=Base64( Algorithm((ValueOfDateHeader), SigningKey) )
シグネチャーバージョン 4

シグネチャーバージョン 4の生成方法は、下記ページをご覧ください。

シグネチャーバージョン 4 生成方法

  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上