Question:
.NET SDKおよびREST APIでOAuth2を利用するにはどうすればよいですか？
Answer:
DocuWare 7.11より、 DocuWareのセキュリティをさらに高めるため、APIにおけるCookie認証が廃止されます 。
.NET SDKおよびREST APIでOAuth2を利用するにはどうすればよいですか？
Answer:
DocuWare 7.11より、 DocuWareのセキュリティをさらに高めるため、APIにおけるCookie認証が廃止されます 。
Cookie AuthenticationからOAuth2への切り替えは、以下の.NET SDKまたはREST APIでのOAuth2への変換方法をご参照ください。
.NET SDKの場合
- .NET SDKの場合、プロジェクトのNuGetパッケージが以下のバージョン概要に示すように最新バージョンに更新されていることを確認してください。バージョン概要｜DocuWare SDK Documentation
*注：OAuth2には、DocuWare.Platform.ServerClientのバージョン13.*以降が必要で、DocuWare.Platform.ServerClient.Extensionsのバージョン11.12.*以降で使用されます。 - サービス接続はバックグラウンドでOAuth2認証を行うため、コードの変更は必要ありません。
REST API
Postman Collectionが更新され、クッキー認証の代わりにOAuth2認証を使用するようになりました。OAuth2を使用して認証するには、以下の一連のリクエストを行う必要があります。
- Get responsible Identity Service -DocuWareプラットフォームのIdentityサービスに関する情報を取得します。
- Get Identity Service Configuration - Identity サービスの OpenID 構成を取得する。
- 以下の要求のいずれかを使用して、認証および認可の目的で使用する Access Token を Identity Service から取得する。
3.a Request Token w/ Username & Password
3.b Request Token w/ a DocuWare Token
3.c Request Token w/ Username & Password (Trusted User)
3.d.1 Obtain Windows Authorization (オンプレミスのみ)
3.d.2 Request Token /w a Windows Account (オンプレミスのみ)
関係するリクエストの詳細、およびクッキー認証の廃止については、以下を参照のこと；
- 関連するリクエスト、DocuWare's Rest APIに関するドキュメント：https://go.docuware.com/restsamples
- クッキー認証の廃止 ： Postmanコレクションの更新｜DocuWare SDK Documentation
*注：オンプレミスのお客様は、これらの変更がDocuWare 7.11で有効になることにご注意ください。DocuWare 7.10以下のシステムでは、引き続きCookie認証を利用できます。
クラウドとオンプレミスの両方の 組織に 適用されるKBA
ご注意：この記事は英語からの翻訳です。この記事に含まれる情報は、オリジナルの英語版製品に基づくものです。翻訳版の記事で使用されている文法などには、細かい誤りがある場合があります。翻訳の正確さを完全に保証することは出来かねますが、ほとんどの場合、十分な情報が得られると思われます。万が一、疑問が生じた場合は、英語版の記事に切り替えてご覧ください。