From 1689a94d65e7ba2c48309cab04d7b2fa75d2f6f4 Mon Sep 17 00:00:00 2001 From: Jason Wong Date: Fri, 22 Oct 2021 09:32:59 +0900 Subject: [PATCH 1/3] bump all the docs down one to make room for token rotation --- docs/_advanced/ja_context.md | 2 +- docs/_advanced/ja_conversation_store.md | 2 +- docs/_advanced/ja_custom_routes.md | 2 +- docs/_advanced/ja_logging.md | 2 +- docs/_advanced/ja_middleware_global.md | 2 +- docs/_advanced/ja_middleware_listener.md | 2 +- docs/_advanced/ja_receiver.md | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/_advanced/ja_context.md b/docs/_advanced/ja_context.md index f8e81822b..21299c217 100644 --- a/docs/_advanced/ja_context.md +++ b/docs/_advanced/ja_context.md @@ -2,7 +2,7 @@ title: context の追加 lang: ja-jp slug: context -order: 6 +order: 7 ---
diff --git a/docs/_advanced/ja_conversation_store.md b/docs/_advanced/ja_conversation_store.md index d711364bb..022f5a870 100644 --- a/docs/_advanced/ja_conversation_store.md +++ b/docs/_advanced/ja_conversation_store.md @@ -2,7 +2,7 @@ title: 会話ストア lang: ja-jp slug: conversation-store -order: 3 +order: 4 ---
diff --git a/docs/_advanced/ja_custom_routes.md b/docs/_advanced/ja_custom_routes.md index 7d2fd0a92..79f8ccb7a 100644 --- a/docs/_advanced/ja_custom_routes.md +++ b/docs/_advanced/ja_custom_routes.md @@ -2,7 +2,7 @@ title: カスタム HTTP ルートの追加 lang: ja-jp slug: custom-routes -order: 9 +order: 10 ---
diff --git a/docs/_advanced/ja_logging.md b/docs/_advanced/ja_logging.md index 72e16cea3..daa46c614 100644 --- a/docs/_advanced/ja_logging.md +++ b/docs/_advanced/ja_logging.md @@ -2,7 +2,7 @@ title: ログの表示 lang: ja-jp slug: logging -order: 7 +order: 8 ---
diff --git a/docs/_advanced/ja_middleware_global.md b/docs/_advanced/ja_middleware_global.md index 147de10c5..cb30dad38 100644 --- a/docs/_advanced/ja_middleware_global.md +++ b/docs/_advanced/ja_middleware_global.md @@ -2,7 +2,7 @@ title: グローバルミドルウェア lang: ja-jp slug: global-middleware -order: 4 +order: 5 ---
diff --git a/docs/_advanced/ja_middleware_listener.md b/docs/_advanced/ja_middleware_listener.md index f9b83dd4d..06e98c434 100644 --- a/docs/_advanced/ja_middleware_listener.md +++ b/docs/_advanced/ja_middleware_listener.md @@ -2,7 +2,7 @@ title: リスナーミドルウェア lang: ja-jp slug: listener-middleware -order: 5 +order: 6 ---
diff --git a/docs/_advanced/ja_receiver.md b/docs/_advanced/ja_receiver.md index e2c97b759..2fb70c10e 100644 --- a/docs/_advanced/ja_receiver.md +++ b/docs/_advanced/ja_receiver.md @@ -2,7 +2,7 @@ title: レシーバーのカスタマイズ lang: ja-jp slug: receiver -order: 8 +order: 9 ---
From 7595df0d898bda2b1eee86919a46d0417c257418 Mon Sep 17 00:00:00 2001 From: Jason Wong Date: Fri, 22 Oct 2021 09:59:48 +0900 Subject: [PATCH 2/3] add first draft for token changes --- docs/_advanced/ja_token_rotation.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 docs/_advanced/ja_token_rotation.md diff --git a/docs/_advanced/ja_token_rotation.md b/docs/_advanced/ja_token_rotation.md new file mode 100644 index 000000000..16fd9542b --- /dev/null +++ b/docs/_advanced/ja_token_rotation.md @@ -0,0 +1,16 @@ +--- +title: トークンのローテーション +lang: ja-jp +slug: token-rotation +order: 3 +--- + +
+Bolt for JavaScript `v3.5.0` から, [OAuth V2 RFC](https://datatracker.ietf.org/doc/html/rfc6749#section-10.4)で定義されているトークンローテーションはアクセストークンのセキュリティーをより一層強化します。 + +トークンローテションを有効にすると既存のインストレーションを表す無期限のアクセストークンの有効期限は切れます。リフレッシュトークンはアクセストークンを再生成する長期的な方法として利用できます。 + +組み込みの [OAuth 機能](https://slack.dev/bolt-js/ja-jp/concepts#authenticating-oauth)を使われている限り、Bolt for JavaScript は自動的にトークンローテーションをサポートします。 + +トークンローテーションについてのより詳細な情報は [API ドキュメント](https://api.slack.com/authentication/rotation)を参照してください。 +
From 5f44f9b95fc07edb2bf7a2cac086f5ef02a26d29 Mon Sep 17 00:00:00 2001 From: Jason Wong Date: Fri, 22 Oct 2021 12:21:48 +0900 Subject: [PATCH 3/3] follow the bolt python docs instead --- docs/_advanced/ja_token_rotation.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/_advanced/ja_token_rotation.md b/docs/_advanced/ja_token_rotation.md index 16fd9542b..dda72f72c 100644 --- a/docs/_advanced/ja_token_rotation.md +++ b/docs/_advanced/ja_token_rotation.md @@ -6,11 +6,11 @@ order: 3 ---
-Bolt for JavaScript `v3.5.0` から, [OAuth V2 RFC](https://datatracker.ietf.org/doc/html/rfc6749#section-10.4)で定義されているトークンローテーションはアクセストークンのセキュリティーをより一層強化します。 +Bolt for JavaScript [v3.5.0](https://github.com/slackapi/bolt-js/releases/tag/%40slack%2Fbolt%403.5.0) から、アクセストークンのさらなるセキュリティ強化のレイヤーであるトークンローテーションの機能に対応しています。トークンローテーションは [OAuth V2 の RFC](https://datatracker.ietf.org/doc/html/rfc6749#section-10.4) で規定されているものです。 -トークンローテションを有効にすると既存のインストレーションを表す無期限のアクセストークンの有効期限は切れます。リフレッシュトークンはアクセストークンを再生成する長期的な方法として利用できます。 +既存の Slack アプリではアクセストークンが無期限に存在し続けるのに対して、トークンローテーションを有効にしたアプリではアクセストークンが失効するようになります。リフレッシュトークンを利用して、アクセストークンを長期間にわたって更新し続けることができます。 -組み込みの [OAuth 機能](https://slack.dev/bolt-js/ja-jp/concepts#authenticating-oauth)を使われている限り、Bolt for JavaScript は自動的にトークンローテーションをサポートします。 +[Bolt for JavaScript の組み込みの OAuth 機能](https://slack.dev/bolt-js/ja-jp/concepts#authenticating-oauth) を使用していれば、Bolt for JavaScript が自動的にトークンローテーションの処理をハンドリングします。 -トークンローテーションについてのより詳細な情報は [API ドキュメント](https://api.slack.com/authentication/rotation)を参照してください。 +トークンローテーションに関する詳細は [API ドキュメント](https://api.slack.com/authentication/rotation)を参照してください。