Soracom

Users

フィードバック

Home ドキュメント Soracom Cloud Camera Services リファレンス

SAM パーミッション (ソラカメ Pro)

SORACOM では、アクセス管理 (SORACOM Access Management: SAM)を利用して、権限を制限したアカウント (SAM ユーザー)を作成できます。

ソラカメ Pro の操作には、ソラカメ Pro 用の権限が必要です。

🔴 既存のソラカメ (ATOM Cam シリーズ)向けに設定した権限では、ソラカメ Pro を操作できません。 ソラカメ Pro は別の API を使用するため、権限の追加が必要です。

権限が不足している場合の症状

ソラカメビューワーにログインできても、カメラの一覧に何も表示されません。 この場合は、下記の権限が設定されているか確認してください。

ソラカメ Pro の操作をすべて許可する

{
  "statements": [
    {
      "effect": "allow",
      "api": [
        "OAuth2:authorize"
      ]
    },
    {
      "effect": "allow",
      "api": [
        "SoraCamV2:*"
      ]
    }
  ]
}

🔑 ソラカメ Pro の API は SoraCamV2: で始まります。 既存のソラカメの API (SoraCam: で始まるもの)とは別の名前です。

既存のソラカメとソラカメ Pro の両方を許可する

{
  "statements": [
    {
      "effect": "allow",
      "api": [
        "OAuth2:authorize"
      ]
    },
    {
      "effect": "allow",
      "api": [
        "SoraCam:*",
        "SoraCamV2:*"
      ]
    }
  ]
}

参照だけを許可する (設定を変更させない)

{
  "statements": [
    {
      "effect": "allow",
      "api": [
        "OAuth2:authorize"
      ]
    },
    {
      "effect": "allow",
      "api": [
        "SoraCamV2:list*",
        "SoraCamV2:get*"
      ]
    }
  ]
}

🔑 この例では、カメラの一覧・設定の確認と録画の再生ができます。 ⚠️ ライブ映像の視聴や、動画・静止画のダウンロードはできません(参照系以外の API を使うため)。カメラの設定変更や契約の変更も許可されません。

⚠️ API 名を個別に列挙している場合はご注意ください

api にワイルドカード (*)を使わず、API 名を 1 つずつ列挙している場合、ソラカメ Pro の API は許可されません。 上記のように SoraCamV2: の権限を追加してください。