Netskope LogoNetskope Logo
  • セキュリティサービス
  • AIサービス
  • ネットワークサービス
  • 分析サービス
  • 統合
  • getting-started.svg始める
    • サポート
    • コミュニティ
    • Netskope.com
    © 2026 無断転載を禁じます。Netskope 株式会社
    トップページ
    Netskope Cloud Exchange
    Cloud Exchangeを始めましょう
    Netskope Borderless WAN Tenant Plugin

    Netskope Borderless WAN Tenant Plugin

    リリースノート

    1.2.0 (Minimum required CE version 6.1.0)

    Added

    • Borderless WANテナントからネットワークイベント(フロー)とアラート(V2)をプルするサポートが追加されました。
    • クライアントおよびゲートウェイエンティティのプルが追加されました。これらはNetskope Borderless WAN Risk Exchangeプラグインに配信されます。エンティティは、最後に変更された時間に基づいて増分的にプルされます。

    1.1.0

    Changed

    • イベントエンドポイントのBorderless WAN APIを更新しました。
    • Cloud Exchangeの互換性情報を更新しました。

    1.0.0

    Added

    • 初回リリース。
    • 監査、認証、クライアント、ゲートウェイ、およびシステムタイプのイベントを取得するためのサポートを追加しました。

    本書では、Cloud ExchangeでNetskope Borderless WAN Tenant v1.2.0プラグインを構成する方法について説明します。このプラグインは、Cloud ExchangeでNetskope Borderless WANテナントを構成するために必要です。Netskope Borderless WANプラグインは、各モジュールに必要なデータを取得するためにテナントを使う。

    前提条件

    この設定を完了するには、以下が必要です。

    • APIトークンを生成する権限を持つNetskope Borderless WANテナント。
    • Netskope Borderless WANテナントホストへの接続。例えば、https://<tenant>.api.infiot.net です。
    • Secrets Managerの構成については、Secrets Manager を参照してください。Azure Key VaultをSecrets Managerとして設定するには、Prerequisites for Azure Key Vault Secrets Manager を参照してください。
    Netskope Borderless WAN Tenant Plugin Support

    このプラグインは、Netskope Borderless WANプラグインで使うNetskope Borderless WANテナントからイベントとアラートをプルします。

    データ型サポート
    イベントの種類はい(監査、認証、クライアント、ゲートウェイ、システム、ネットワークイベント)
    アラートの種類はい(アラート(V2))
    ウェブテキサスサポートされていません
    権限

    認証トークンには、以下の権限が必要です。

    [
      {
        "rap_resource": "*",
        "rap_privs": [
          "privAddressGroupCreate",
          "privAddressGroupRead",
          "privAddressGroupWrite",
          "privAddressObjectCreate",
          "privAddressObjectDelete",
          "privAddressObjectRead",
          "privAuditRecordRead",
          "privCustomAppCreate",
          "privCustomAppDelete",
          "privCustomAppRead",
          "privCustomAppWrite",
          "privManagedDeviceRead",
          "privMonitorAlertRead",
          "privPolicyRead",
          "privSiteRead",
          "privTenantRead",
          "privUserRead"
        ]
      }
    ]
    これらの権限は、Log ShipperとRisk Exchangeの両方のNetskope Borderless WANプラグインをカバーします。単一のプラグインに必要な権限については、そのプラグインのガイドを参照してください。
    APIの詳細
    使うAPI一覧
    APIエンドポイント方法使うケース
    /v2/auditevents得るBorderless WANテナントからイベント(監査、認証、クライアント、ゲートウェイ、システム)を取得します。
    /v2/networkevents得るBorderless WANテナントからネットワークイベント(フロー/トラフィックログ)を取得します。
    /v2/alerts得るBorderless WANテナントからアラート(V2)を取得します。
    イベントの取得

    API Endpoint: <BASE URL>/v2/auditevents
    Method: GET

    Request Headers

    鍵Value
    AuthorizationBearer <API TOKEN>
    ユーザーエージェントnetskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0

    Request Parameters

    鍵Value
    first100
    afterend_cursor(前回の応答からの終了カーソル)
    filterevent_time>=’<START TIME>‘ AND event_time<‘<END TIME>‘ AND (type: <EVENT TYPE>)

    Sample API Response

    {
        "page_info": {
            "end_cursor": "WyIyMDI1LTAxLTI5VDEyOjQzOjIyLjAzNVoiLCI2NzlhMjI2YTIyNmUyYTBmYzU2YzJjOGIiXQ",
            "has_next": true,
            "total_count": 4
        },
        "data": [
            {
                "id": "679a226a226e2a0fc56c2c8b",
                "actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:token:6245b39c611790724910338f",
                "target_nrn": "nrn:bwan:site:us:5dadf8a91602d141e060c93e:site:673757abb51faf57f043a36a",
                "type": "AUDIT",
                "subtype": "AUDIT_GATEWAY",
                "activity": "SITE_UPDATED",
                "note": "",
                "event_time": "2025-01-29T12:43:22Z"
            },
            {
                "id": "679a24c905aa7377e0924ab0",
                "actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:user:656e127fd8a92afdc8447576",
                "target_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:user:656e127fd8a92afdc8447576",
                "type": "AUTHENTICATION",
                "subtype": "AUTHENTICATION_USER",
                "activity": "USER_LOGIN",
                "note": "",
                "event_time": "2025-01-29T12:53:29Z"
            },
            {
                "id": "679a20d105aa7377e0924931",
                "actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:token:675145c90f1ebb6e8c59983b",
                "target_nrn": "nrn:bwan:site:us:5dadf8a91602d141e060c93e:site:675145b90f1ebb6e8c59982a",
                "type": "CLIENT",
                "subtype": "CLIENT_SYSTEM",
                "activity": "SITE_CLIENT_DEVICE_ENROLL_STARTED",
                "note": "",
                "event_time": "2025-01-29T12:36:34Z"
            },
            {
                "id": "679a259d05aa7377e0924afa",
                "actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:token:67343709ca023562f3b8f02e",
                "target_nrn": "nrn:bwan:site:us:5dadf8a91602d141e060c93e:site:6734367c1f66fecb2dff8554",
                "type": "GATEWAY",
                "subtype": "GATEWAY_UNDERLAY",
                "activity": "SITE_LINK_UP",
                "note": "wlp0s0",
                "event_time": "2025-01-29T12:57:00Z"
            },
            {
                "id": "679a25b439a4bd42a70bb934",
                "actor_nrn": "nrn:bwan:authn:us:5dadf8a91602d141e060c93e:token:6245b39c611790724910338f",
                "target_nrn": "nrn:bwan:tenant:us:5dadf8a91602d141e060c93e:tenant:5dadf8a91602d141e060c93e",
                "type": "SYSTEM",
                "subtype": "SYSTEM_SSE_TUNNEL",
                "activity": "SITE_NS_TUNNEL_ERROR",
                "note": "https://tunnel-test.goskope.com (accountId: 62b3a3e3b7f108a3b8b74815): get tunnels: status: 401 -> Unauthorized\naccountId: 62b3a3e3b7f108a3b8b74815",
                "event_time": "2025-01-29T12:57:24Z"
            }
        ]
    }
    ネットワークイベントの取得

    API Endpoint: <BASE URL>/v2/networkevents
    Method: GET

    Request Headers

    鍵Value
    AuthorizationBearer <API TOKEN>
    ユーザーエージェントnetskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0

    Request Parameters

    鍵Value
    first100
    afterend_cursor(前回の応答からの終了カーソル)
    filterended_at>=’<START TIME>‘ AND ended_at<‘<END TIME>‘

    Sample API Response

    {
        "page_info": {
            "end_cursor": "WyIyMDI2LTEwLTIxVDEyOjE1OjE1Ljk4WiIsIjc5NjRkYzU2MmFiNDViNTQiXQ",
            "has_next": true
        },
        "data": [
            {
                "id": "M2JlMDZjNzNmOGNlYjM1MXwyMDI2LTEwLTIxVDEyOjE1OjM2LjM2N1p8ODk2NzcxODkxMjQ5NDg1NzgyNw==",
                "source_ip": "169.254.3.132",
                "destination_ip": "169.254.3.167",
                "source_port": 7777,
                "destination_port": 7777,
                "mac": "00:00:00:00:00:00",
                "device_name": "169.254.3.132",
                "application_id": "216",
                "application_name": "User Datagram Protocol",
                "site_id": "69dfd187fdab1797f44a3a92",
                "in_interface_logical_name": "GE1",
                "out_interface_logical_name": "GE1",
                "started_at": "2026-10-09T14:17:03Z",
                "ended_at": "1970-01-01T00:00:00Z",
                "packets_sent": 50,
                "packets_received": 0,
                "bytes_sent": 1943,
                "bytes_received": 0,
                "duration_millis": 1029512888,
                "protocol": "UDP",
                "peer_type": "INFIOT",
                "peer_role": "SPOKE",
                "vpn_nat_source_ip": "0.0.0.0",
                "vpn_nat_source_port": 0,
                "vpn_nat_destination_ip": "0.0.0.0",
                "segment_id": 0,
                "latency_millis": 0,
                "destination_country": "Reserved/Private",
                "scheduler_queue": "HIGH",
                "rx_loss_percent": 0,
                "tx_loss_percent": 0,
                "network_latency_millis": 0,
                "jitter_millis": 0,
                "peer_name": "mgmtgw",
                "is_closed": false
            },
            {
                "id": "Nzk2NGRjNTYyYWI0NWI1NHwyMDI2LTEwLTIxVDEyOjE1OjE1Ljk4WnwxMDg2OTkwMzY2MDUwNjA5NTcy",
                "source_ip": "169.254.0.53",
                "destination_ip": "169.254.2.251",
                "source_port": 7777,
                "destination_port": 7777,
                "mac": "00:00:00:00:00:00",
                "device_name": "169.254.0.53",
                "application_id": "216",
                "application_name": "User Datagram Protocol",
                "site_id": "68107a34144df1459e958e47",
                "in_interface_logical_name": "GE1",
                "out_interface_logical_name": "GE2",
                "started_at": "2026-10-19T03:30:28Z",
                "ended_at": "1970-01-01T00:00:00Z",
                "packets_sent": 245257,
                "packets_received": 0,
                "bytes_sent": 9509853,
                "bytes_received": 0,
                "duration_millis": 204287046,
                "protocol": "UDP",
                "peer_type": "INFIOT",
                "peer_role": "SPOKE",
                "vpn_nat_source_ip": "0.0.0.0",
                "vpn_nat_source_port": 0,
                "vpn_nat_destination_ip": "0.0.0.0",
                "segment_id": 0,
                "latency_millis": 0,
                "destination_country": "Reserved/Private",
                "scheduler_queue": "HIGH",
                "rx_loss_percent": 0,
                "tx_loss_percent": 0,
                "network_latency_millis": 10,
                "jitter_millis": 0,
                "peer_name": "mp-vm-spoke",
                "is_closed": false
            }
        ]
    }
    アラート(V2)を取得します。

    API Endpoint: <BASE URL>/v2/alerts
    Method: GET

    Request Headers

    鍵Value
    AuthorizationBearer <API TOKEN>
    ユーザーエージェントnetskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0

    Request Parameters

    鍵Value
    first100
    afterend_cursor(前回の応答からの終了カーソル)
    filter(opened_at>=’<START TIME>‘ AND opened_at<‘<END TIME>‘) OR (closed_at>=’<START TIME>‘ AND closed_at<‘<END TIME>‘)

    Sample API Response

    {
        "page_info": {
            "end_cursor": "WyI2YWM4MWIyZGEyMTk4M2E1YjVkN2M0ZWQiXQ",
            "has_next": true,
            "total_count": 972
        },
        "data": [
            {
                "id": "6ac81b2d1c9449a3ebdc193a",
                "monitor_id": "6ac73666fa4016413e66fe7c",
                "labels": {
                    "site_id": "6a7042ea0dfbcddb54899f92",
                    "site_name": "mgmtgw"
                },
                "state": "open",
                "severity": "medium",
                "opened_at": "2026-10-08T22:37:33Z"
            },
            {
                "id": "6ac81b2da21983a5b5d7c4ed",
                "monitor_id": "6ac7dac96ba9932eb61a8e11",
                "labels": {
                    "site_name": "mgmtgw",
                    "site_id": "6a7042ea0dfbcddb54899f92"
                },
                "state": "closed",
                "severity": "critical",
                "opened_at": "2026-10-08T22:37:33Z",
                "closed_at": "2026-10-09T11:03:49Z"
            }
        ]
    }
    ユーザーエージェント

    netskope-ce-7.0.0-tenant-netskope_borderless_wan-v1.2.0

    ワークフロー
    1. Netskope Borderless WANテナント用の認証トークンを生成します。
    2. Configure the Netskope Borderless WAN Tenant plugin.
    3. Validate the Netskope Borderless WAN Tenant plugin.

    動画を見る

    再生ボタンをクリックして動画をご覧ください。

     

    認証トークンを生成する

    1. Netskope Borderless WANテナントにログインします。

    2. Settings > API Tokenに移動してNew Tokenをクリックしてください。

    3. 要件に従って、トークン名、有効期限、およびデスクリプションを入力します。

      トークンの権限については、本書の「権限」を参照してください。
    4. Saveをクリックして、生成されたトークンをコピーしてください。

      生成されたトークンを使用して、Cloud ExchangeでNetskope Borderless WANテナントを構成します。

    Configure the Netskope Borderless WAN Tenant Plugin

    1. Cloud Exchange で、 Settings > Plugin Storeに移動します。Netskope Borderless WAN Tenant v1.2.0プラグインを検索して選択してください。

    2. 名前、完全なテナントベースURL(例:https://<tenant>.api.infiot.net)、そして前に生成した認証トークンを入力します。

    3. Saveをクリックしてください。

    Validate the Netskope Borderless WAN Tenant Plugin

    Cloud Exchangeで設定されたBorderless WANテナントを検証するには、Settings > Tenantsに移動します。新しく設定されたテナントが設定済みテナントリストに表示されます。

    Troubleshooting the Netskope Borderless WAN Tenant Plugin

    テナントの設定中にエラーが発生しました

    TENANT Netskope Borderless WAN Tenant [BWAN Tenant デモ]: Validation error occurred. Unable to establish connection with Netskope Borderless WAN プラットフォーム. Proxy server or Netskope Borderless WAN server is not reachable.が表示される場合

    What to do: テナントのベースURLが正しく入力されていることを確認してください。形式については、「前提条件」を参照してください。

    TENANT Netskope Borderless WAN Tenant [BWAN Tenant デモ]: Validation error occurred. Invalid Auth Token provided in the configuration parameters. Make sure that the Auth Token has all the required permissions and is not expired.が表示される場合

    What to do:

    1. テナントの認証トークンが正しく入力されていることを確認します。
    2. 認証トークンに必要な権限があることを確認してください。認証トークンの生成を参照してください。
    このトピックでは
    • Netskope Borderless WAN Tenant Plugin