Tips

【Netskopeをご利用中の皆様へ】Netskope REST API v1 一部エンドポイントの EoL について

Netskope 社、および当社ヘルプデスクよりアナウンスされております REST API v1 一部エンドポイントの EoL についてご案内いたします。

REST API v1 一部エンドポイントの EoL について

Netskope 社、および当社ヘルプデスクからアナウンスさせていただいております通り、2025/1/31 に REST API v1 の一部エンドポイントが EoL となります。

EoL 以降、該当するエンドポイントを利用した情報の取得などができなくなります。

※当初 2024/10/31 に EoL 予定でしたが、延期され 2025/1/31 に EoL 予定となっております。

マイルストーン

マイルストーン

定義

日付

EOL Announcement Date

EOL通知が一般に公開される日付です。

2024年4月1日

EOS Date

この日付以降、REST API v1エンドポイントは統合できなくなります(R123)。
すべてのREST API v1エンドポイントのドキュメントはアーカイブされます。

2025年1月31日

廃止対象の REST API v1 エンドポイントと移行先 REST API v2 エンドポイント一覧

廃止される REST API v1 エンドポイント

移行先 REST API v2 エンドポイント

/api/v1/alerts

/api/v2/events/dataexport/alerts/uba
/api/v2/events/dataexport/alerts/securityassessment
/api/v2/events/dataexport/alerts/quarantine
/api/v2/events/dataexport/alerts/remediation
/api/v2/events/dataexport/alerts/policy
/api/v2/events/dataexport/alerts/malware
/api/v2/events/dataexport/alerts/malsite
/api/v2/events/dataexport/alerts/compromisedcredential
/api/v2/events/dataexport/alerts/ctep
/api/v2/events/dataexport/alerts/dlp
/api/v2/events/dataexport/alerts/watchlist

/api/v1/events

/api/v2/events/dataexport/events/application
/api/v2/events/dataexport/events/audit
/api/v2/events/dataexport/events/connection
/api/v2/events/dataexport/events/incident
/api/v2/events/dataexport/events/infrastructure
/api/v2/events/dataexport/events/network
/api/v2/events/dataexport/events/page

/api/v1/role

/api/v2/platform/roles

/api/v1/updateUrlList

/api/v2/policy/urllist

addon-*.goskope.com/SCIM/v2

/api/v2/scim/Users
/api/v2/scim/Groups

上記のエンドポイントを利用しているユーザー様におかれましては、REST API v2 エンドポイントへの移行をお願いいたします。

特に SCIM エンドポイントをご利用の場合、EoL 以降は新規ユーザーのプロビジョニングが正常に実施できなくなります

Base URL (Okta) または Tenant URL(Entra ID) をご確認いただき、https://addon-<tenant-name>.goskope.com/api/v2/scim が設定されている場合は REST API v2 への移行を実施いただければと存じます。

参考ドキュメント

REST API v2 につきましては下記メーカードキュメントをご参照ください。
REST API v2 Overview – Netskope Knowledge Portal

REST API v2 SCIM エンドポイントのトークン生成方法については下記メーカードキュメントをご参照ください。
SCIM Settings for User Provisioning – Netskope Knowledge Portal

Entra ID、Okta での REST API v2 設定方法につきましては下記メーカードキュメントをご参照ください。

Entra ID
User Provisioning with Entra ID – Netskope Knowledge Portal

Okta
User Provisioning with OKTA – Netskope Knowledge Portal

最後に

年始の忙しいタイミングとなりますが、廃止対象のエンドポイントをご利用の場合は REST API v2 への移行を実施いただければと存じます。

この記事に関連する製品・サービス

この記事に関連する記事