ログインフリーのパスワードレスリンクを生成して、Simple Log Service (SLS) のページ (クエリ結果、ダッシュボード) を他のユーザーと共有したり、サードパーティシステムに埋め込んだりできます。
注意事項
単一リンクの生成
ページを一時的に共有するには、次の手順でパスワードレスのワンタイムリンクを生成します。
チケットの生成とパスワードレスおよびログイン不要リンクの作成
ステップ 1: リンクの準備
-
クエリと分析ページ:
https://sls.console.alibabacloud.com/lognext/project/<Project name>/logsearch/<Logstore name>?slsRegion=<Project region>&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=trueプロジェクト名は「プロジェクトの管理」から、Logstore 名は「Logstore の管理」から、リージョン ID は「エンドポイント」から取得します。
-
クエリページ:
https://sls.console.alibabacloud.com/lognext/project/<Project name>/logsearch/<Logstore name>?slsRegion=<Project region>&isShare=true&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true -
ダッシュボードページ:
説明[ダッシュボード ID] は、表示名ではなく URL 内の ID です。 SLS コンソールの「パスワードなしでダッシュボードを共有」機能を使用することもできます。
https://sls.console.alibabacloud.com/lognext/project/<Project name>/dashboard/<Dashboard ID>?slsRegion=<Project region>&isShare=true&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true
ステップ 2: チケット認証情報の取得
CreateTicket API を呼び出してチケットを取得します。 このオペレーションを呼び出すには、China (Shanghai) または Singapore エンドポイントを選択する必要があります。 ただし、取得したチケットはどのリージョンでも使用できます。 生成された各チケットは、同じブラウザまたはホストからのみアクセスできます。 チケットはデフォルトで 1 日間、最大で 30 日間有効です。
ステップ 3: リンクの作成
-
ステップ 1 のリンクとチケットを連結して、パスワードレスおよびログイン不要でアクセスするためのリンクを生成します。
https://sls.console.alibabacloud.com/lognext/project/<Project name>/dashboard/<Dashboard ID>?slsRegion=<Project region>&sls_ticket=eyJ***************.eyJ******************.KUT****************&isShare=true&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true -
リンクをテストします。 生成されたリンクをブラウザのアドレスバーに入力してテストできます。 共有された Simple Log Service コンソールページが開けば、ログイン不要のリンクは正常に生成されています。
重要-
このテストで、ブラウザでログイン不要のリンクを初めて開くことになります。 テスト後、チケットは無効になります。 新しいチケットを取得する必要があります。
-
リンクをファイルにコピーしてからファイルを転送することを推奨します。 サードパーティのアプリケーションでリンクを直接送信すると、アプリケーションがリンクを読み取った場合にリンクが無効になる可能性があります。
-
サードパーティ埋め込み用リンクを動的に生成
サードパーティシステムにコンソールページを埋め込む場合は、現在のチケットが期限切れになる前に、CreateTicket API を動的に呼び出して新しいチケットを取得します。セキュリティリスクを軽減するため、RAM ユーザーの AccessKey ペアではなく、一時的な STS トークンを持つ RAM ロールを使用してください。
動的なチケットの生成
-
チケットはデフォルトで 24 時間有効で、最大 30 日間有効です。
-
生成できるチケットの総数に制限はありません。CreateTicket API の 1 秒あたりのクエリ数 (QPS) の制限は、ユーザーあたり毎秒 10 回です。
-
RAM ロールを使用して CreateTicket API を呼び出します。
-
RAM ユーザーを使用して AssumeRole API を呼び出し、SecurityToken、AccessKeySecret、および AccessKeyId を取得します。
-
RAM ユーザーはこれら 3 つのパラメーターを使用して RAM ロールを引き受け、CreateTicket API を呼び出してチケットを取得します。
-
-
返されたチケットに基づいて、異なる権限スコープを持つパスワードレスリンクを作成します。
リンクのアクセス時間の延長
チケットの有効期間は短いため、RefreshToken オペレーションを使用してパスワードレスリンクのアクセス時間を延長してください。
有効期限が切れたチケットのアクセス時間を延長
ステップ 1:リンクにパラメーターを追加する
生成されたリンクに supportRefreshToken=true パラメーターを追加して、アクセス時間を延長できるようにします。
https://sls.console.alibabacloud.com/lognext/project/<プロジェクト名>/dashboard/<ダッシュボード ID>?sls_ticket=eyJ***************.eyJ******************.KUT****************&supportRefreshToken=true&isShare=true&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true
ステップ 2:クライアントにリスナーイベントを追加する
クライアントは message イベントをリッスンし、最新の accessToken を iframe に渡します。
window.addEventListener('message', async (e) => {
if (e?.data?.type === 'refreshToken') {
const accessToken = await callApi()
document.querySelector('#myIframe').contentWindow.postMessage(
{
// 固定値: applyAccessToken
type: 'applyAccessToken',
// callApi() の呼び出しで返される accessToken
accessToken,
// CreateTicket API で返されるチケット
ticket: e.data.ticket,
},
'*'
)
}
})
クライアントでは、callApi() はサーバー側 API を呼び出すためのカスタムメソッドです。サーバー側 API は RefreshToken API を呼び出して accessToken を取得します。以下にコード例を示します。
RefreshToken 操作には 2 つの入力パラメーターがあります。ticket は CreateTicket によって生成されるチケットで、accessTokenExpirationTime はこの操作によって生成されるアクセストークンの有効期限を秒単位で指定します。デフォルト値は 86,400 秒 (1 日) で、最大値も 86,400 秒 (1 日) です。ticket の有効期間は最大 30 日間延長できます。30 日が経過すると、ticket は失効します。
Java
-
Maven 依存関係を追加します。
Java プロジェクトのルートディレクトリで、pom.xml ファイルを開き、次のコードを追加します。
<dependency> <groupId>com.aliyun</groupId> <artifactId>sls20201230</artifactId> <version>5.2.1</version> </dependency> <dependency> <groupId>com.aliyun</groupId> <artifactId>tea-openapi</artifactId> <version>0.3.2</version> </dependency> <dependency> <groupId>com.aliyun</groupId> <artifactId>tea-console</artifactId> <version>0.0.1</version> </dependency> <dependency> <groupId>com.aliyun</groupId> <artifactId>tea-util</artifactId> <version>0.2.21</version> </dependency> -
accessTokenを生成します。// このファイルは自動生成されています。編集しないでください。 package com.aliyun.sample; import com.aliyun.sls20201230.Client; import com.aliyun.tea.*; public class Sample { /** * アクセスキーペアを使用してクライアントを初期化します。 * @return Client * @throws Exception */ public static Client createClient() throws Exception { // プロジェクトコードが漏洩すると、アクセスキーペアが公開され、アカウント内のすべてのリソースのセキュリティが危険にさらされる可能性があります。次のサンプルコードは参考用です。 // より安全な STS 方式を使用することを推奨します。 com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config() // 必須。ランタイム環境に ALIBABA_CLOUD_ACCESS_KEY_ID 環境変数が設定されていることを確認してください。 .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")) // 必須。ランタイム環境に ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。 .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")); // エンドポイントの詳細については、https://api.alibabacloud.com/product/Sls をご参照ください。エンドポイントは、China (Shanghai) または Singapore である必要があります。 config.endpoint = "cn-shanghai.log.aliyuncs.com"; return new Client(config); } public static void main(String[] args_) throws Exception { java.util.List<String> args = java.util.Arrays.asList(args_); com.aliyun.sls20201230.Client client = Sample.createClient(); com.aliyun.sls20201230.models.RefreshTokenRequest refreshTokenRequest = new com.aliyun.sls20201230.models.RefreshTokenRequest() .setTicket("eyJ***************.eyJ******************.KUT****************") .setAccessTokenExpirationTime(86400L); com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions(); java.util.Map<String, String> headers = new java.util.HashMap<>(); try { com.aliyun.sls20201230.models.RefreshTokenResponse resp = client.refreshTokenWithOptions(refreshTokenRequest, headers, runtime); com.aliyun.teaconsole.Client.log(com.aliyun.teautil.Common.toJSONString(resp)); } catch (TeaException error) { // これは表示とデモのみを目的としています。例外は慎重に処理してください。プロジェクトで例外を無視しないでください。 // エラーメッセージ System.out.println(error.getMessage()); // トラブルシューティング URL System.out.println(error.getData().get("Recommend")); com.aliyun.teautil.Common.assertAsString(error.message); } catch (Exception _error) { TeaException error = new TeaException(_error.getMessage(), _error); // これは表示とデモのみを目的としています。例外は慎重に処理してください。プロジェクトで例外を無視しないでください。 // エラーメッセージ System.out.println(error.getMessage()); // トラブルシューティング URL System.out.println(error.getData().get("Recommend")); com.aliyun.teautil.Common.assertAsString(error.message); } } }
Python
# -*- coding: utf-8 -*-
# このファイルは自動生成されています。編集しないでください。
import os
import sys
from typing import List
from alibabacloud_sls20201230.client import Client as Sls20201230Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_sls20201230 import models as sls_20201230_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient
class Sample:
def __init__(self):
pass
@staticmethod
def create_client() -> Sls20201230Client:
"""
アクセスキーペアを使用してクライアントを初期化します。
@return: Client
@throws Exception
"""
# プロジェクトコードが漏洩すると、アクセスキーペアが公開され、アカウント内のすべてのリソースのセキュリティが危険にさらされる可能性があります。次のサンプルコードは参考用です。
# より安全な STS 方式を使用することを推奨します。
config = open_api_models.Config(
# 必須。ランタイム環境に ALIBABA_CLOUD_ACCESS_KEY_ID 環境変数が設定されていることを確認してください。
access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
# 必須。ランタイム環境に ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
)
# エンドポイントの詳細については、https://api.alibabacloud.com/product/Sls をご参照ください。エンドポイントは、China (Shanghai) または Singapore である必要があります。
config.endpoint = 'cn-shanghai.log.aliyuncs.com'
return Sls20201230Client(config)
@staticmethod
def main(
args: List[str],
) -> None:
client = Sample.create_client()
refresh_token_request = sls_20201230_models.RefreshTokenRequest(
ticket='eyJ***************.eyJ******************.KUT****************',
access_token_expiration_time=86400
)
runtime = util_models.RuntimeOptions()
headers = {}
try:
# このコードをコピーして実行する場合は、API の戻り値をご自身で出力してください。
client.refresh_token_with_options(refresh_token_request, headers, runtime)
except Exception as error:
# これは表示とデモのみを目的としています。例外は慎重に処理してください。プロジェクトで例外を無視しないでください。
# エラーメッセージ
print(error.message)
# トラブルシューティング URL
print(error.data.get("Recommend"))
UtilClient.assert_as_string(error.message)
@staticmethod
async def main_async(
args: List[str],
) -> None:
client = Sample.create_client()
refresh_token_request = sls_20201230_models.RefreshTokenRequest(
ticket='eyJ***************.eyJ******************.KUT****************',
access_token_expiration_time=86400
)
runtime = util_models.RuntimeOptions()
headers = {}
try:
# このコードをコピーして実行する場合は、API の戻り値をご自身で出力してください。
await client.refresh_token_with_options_async(refresh_token_request, headers, runtime)
except Exception as error:
# これは表示とデモのみを目的としています。例外は慎重に処理してください。プロジェクトで例外を無視しないでください。
# エラーメッセージ
print(error.message)
# トラブルシューティング URL
print(error.data.get("Recommend"))
UtilClient.assert_as_string(error.message)
if __name__ == '__main__':
Sample.main(sys.argv[1:])
ページ表示の調整
コンソールページの埋め込み用パラメーターの設定に記載の UI パラメーターを使用して、埋め込みページの表示を調整します。
大画面でのダッシュボード表示
大画面ディスプレイで長期間表示する場合は、ダッシュボードのパスワードレス共有・統合 機能を使用してください。
-
Simple Log Service (SLS) コンソールで、ダッシュボードをすばやく作成します。
-
パスワードレス共有を作成し、有効期間に [長期] を選択します。
-
共有リンクを開き、ディスプレイで [フルスクリーン] を選択します。更新間隔を設定して、リアルタイムでデータを更新することもできます。
ダッシュボードの共有とコラボレーション
PC、DingTalk、WeCom、または Ali-Ding で共有されているダッシュボードを表示します。他の Alibaba Cloud アカウント、RAM ユーザー、DingTalk アカウント、WeCom アカウント、または Ali-Ding ユーザーとダッシュボードを共有します。
シナリオ 1:アカウント間でのダッシュボード共有
あるチームには複数の Alibaba Cloud アカウントがあります。アカウント A の RAM-User-A は、アカウント B の RAM-User-B にダッシュボードを共有して閲覧させたいと考えています。
-
Simple Log Service コンソールで、
RAM-User-Aが ダッシュボードを作成して [パスワードなしの共有を作成] をクリックし、[アクセス制限] で「Alibaba Cloud アカウント」を選択して、[Alibaba Cloud アカウント ID] に、RAM-User-Bの [アカウント ID] を入力します。 -
RAM-User-Bがログインし、共有リンクを開いてダッシュボードを表示します。
シナリオ 2:アプリケーション間でのダッシュボード共有
ある企業は、業務で DingTalk または WeCom を使用しています。運用チームがコンソールでダッシュボードを作成し、開発者が DingTalk または WeCom アカウントで表示できるように共有します。
-
DingTalk 組織管理者 または WeCom 管理者を使用してコードをスキャンし、[アプリケーション] をアクティブ化します。
-
Alibaba Cloud アカウントでコンソールにログインし、ホームページの右側にある下矢印をクリックします。
-
RAM ユーザーは、ダッシュボード用に [パスワードなし共有の作成] を行います。これを行うには、[アクセス制限] を [DingTalk アカウント] に設定し、ダッシュボードにアクセスできるユーザーアカウントを選択します。また、[すべて] を選択することもできます。
-
共有先の DingTalk ユーザーは、Alibaba Cloud にログインすることなく、DingTalk PC クライアントまたはモバイルアプリで直接ダッシュボードを表示できます。
-
DingTalk の [ワークベンチ] ページで [すべて] タブをクリックし、[SLS 共有 & ログインフリー] をクリックします。
-
[詳細を表示] をクリックします。
-
-
または、DingTalk にログインした後、ユーザーは共有リンクを使用してブラウザで直接ダッシュボードを表示できます。
-
共有元の RAM ユーザーがダッシュボードリンクをコピーし、DingTalk ユーザーに送信します。 [パスワードレス共有管理] ページで、共有レコードの [操作] 列にある [リンクをコピー] をクリックします。
-
リンクをブラウザのアドレスバーに貼り付けて表示します。
-
埋め込みページの権限分離
クエリ結果またはダッシュボードをサードパーティシステムに埋め込む際、ユーザー権限の分離が可能です。以下のシナリオで手順を説明します。
シナリオ 1:ユーザーが同じ権限を持つ場合
シナリオ:同じプロジェクトから 2 つの Logstore を埋め込みます。すべてのユーザーは、指定された Logstore に対する読み取り専用権限と、プロジェクト内の保存済み検索およびダッシュボードに対する読み取り専用権限を持ちます。
手順
-
共有者として
sls-user-aという名前の RAM ユーザーを作成します。詳細については、「RAM ユーザーの作成」をご参照ください。 -
RAM ユーザー
sls-user-aに権限を付与します。-
特定のリソース (プロジェクト、Logstore) にアクセスするための
Allow-AccessLogstoreという名前の権限ポリシーを作成します。詳細については、「カスタムポリシーの作成」をご参照ください。説明<Your Project Name>、<Your Logstore Name A>、<Your Logstore Name B> を実際のプロジェクト名と Logstore 名に置き換えてください。
{ "Version": "1", "Statement": [ { "Action": [ "log:ListProject" ], "Resource": "acs:log:*:*:project/*", "Effect": "Allow" }, { "Action": [ "log:List*" ], "Resource": "acs:log:*:*:project/<Your Project Name>/logstore/*", "Effect": "Allow" }, { "Action": [ "log:Get*", "log:List*" ], "Resource": [ "acs:log:*:*:project/<Your Project Name>/logstore/<Your Logstore Name A>", "acs:log:*:*:project/<Your Project Name>/logstore/<Your Logstore Name B>" ], "Effect": "Allow" }, { "Action": [ "log:Get*", "log:List*" ], "Resource": [ "acs:log:*:*:project/<Your Project Name>/dashboard", "acs:log:*:*:project/<Your Project Name>/dashboard/*" ], "Effect": "Allow" }, { "Action": [ "log:Get*", "log:List*" ], "Resource": [ "acs:log:*:*:project/<Your Project Name>/savedsearch", "acs:log:*:*:project/<Your Project Name>/savedsearch/*" ], "Effect": "Allow" } ] } -
RAM ユーザー
sls-user-aにAllow-AccessLogstore権限を付与します。埋め込みページにアクセスするユーザーはこの権限を継承します。詳細については、「カスタムポリシーの例」をご参照ください。 -
CreateTicket API を呼び出すための
Allow-CreateTicketという名前の権限ポリシーを作成します。詳細については、「カスタムポリシーの作成」をご参照ください。{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": "log:CreateTicket", "Resource": "acs:log:*:*:ticket/*" } ] } -
RAM ユーザーに
Allow-CreateTicket権限を付与します。詳細については、「RAM ユーザーへの権限付与」をご参照ください。
-
-
独自のフロントエンドページに Logstore 選択ボックスまたはタブを作成して、Logstore を切り替えることができます。
-
ユーザーが埋め込みページにアクセスする際、RAM ユーザー
sls-user-aを使用して CreateTicket API を呼び出し、チケットを取得します。次の例では Java SDK を使用します。説明CreateTicket ページで API をデバッグしてチケットを取得できます。取得したチケットをクエリページの URL に追加してアクセスします。
-
Maven 依存関係を追加します。
Java プロジェクトのルートディレクトリで、pom.xml ファイルを開き、次のコードを追加します。
<dependency> <groupId>com.aliyun</groupId> <artifactId>sls20201230</artifactId> <version>5.5.0</version> </dependency> -
-
-
取得したチケットをクエリページの URL に追加します。サイドバーとトップバーを非表示にし、タブ履歴を無効にすることもできます (
hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true)。詳細については、「コンソールページの埋め込みに関するパラメーターの設定」をご参照ください。https://sls.console.alibabacloud.com/lognext/project/<Project name>/logsearch/<Logstore name>?slsRegion=<Project region>&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true&sls_ticket=eyJ***************.eyJ******************.KUT**************** -
Logstore を切り替えるには、生成されたチケットを同じブラウザで URL に追加することで再利用できます。
説明同じブラウザで API を再度呼び出す必要はありません。異なるユーザー (異なるブラウザ) は、再度 CreateTicket を呼び出す必要があります。チケットは 1 つのブラウザまたはホストからのみアクセスできます。
シナリオ 2:ユーザーが異なる権限を持つ場合
シナリオ:2 つのプロジェクトを埋め込みます。ユーザー A は Project-A への読み取り専用アクセス権があり、ユーザー B は Project-B への読み取り専用アクセス権があります。
手順
-
共有者として
sls-user-aという名前の RAM ユーザーを作成します。詳細については、「RAM ユーザーの作成」をご参照ください。 -
STS AssumeRole API を呼び出すために、RAM ユーザー
sls-userに AliyunSTSAssumeRoleAccess 権限を付与します。詳細については、「RAM ユーザーへの権限付与」をご参照ください。 -
sls-roleという名前の RAM ロールを作成します。詳細については、「信頼された Alibaba Cloud アカウントの RAM ロールを作成」をご参照ください。 -
RAM ロール
sls-roleに、特定のリソース (プロジェクト) に対する権限と CreateTicket API を呼び出す権限を付与します。-
特定のリソース (プロジェクト) にアクセスするための
Allow-AccessProjectという名前の権限ポリシーを作成します。このポリシーには、すべてのユーザー権限の和集合が含まれます。詳細については、「カスタムポリシーの作成」をご参照ください。この場合、Project-AとProject-Bへの読み取り専用アクセスが必要です。権限ポリシーは次のとおりです。説明<Your Project Name A> と <Your Project Name B> を実際のプロジェクト名に置き換えてください。
{ "Version": "1", "Statement": [ { "Action": [ "log:Get*", "log:List*" ], "Resource": [ "acs:log:*:*:project/<Your Project Name A>/*", "acs:log:*:*:project/<Your Project Name A>", "acs:log:*:*:project/<Your Project Name B>/*", "acs:log:*:*:project/<Your Project Name B>" ], "Effect": "Allow" } ] } -
RAM ロール
sls-roleにAllow-AccessProject権限を付与します。詳細については、「RAM ロールへの権限付与」をご参照ください。 -
CreateTicket API を呼び出すための
Allow-CreateTicketという名前の権限ポリシーを作成します。詳細については、「カスタムポリシーの作成」をご参照ください。{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": "log:CreateTicket", "Resource": "acs:log:*:*:ticket/*" } ] } -
RAM ロール
sls-roleにAllow-CreateTicket権限を付与します。詳細については、「RAM ロールへの権限付与」をご参照ください。
-
-
RAM ロールの最大セッション期間を設定します。デフォルトは 1 時間です。埋め込みページの有効期間は、この時間より短くなります。
-
ユーザーが埋め込みページにアクセスする際、RAM ユーザー
sls-userを使用して RAM ロールsls-roleを引き受け、AssumeRole API を呼び出します。次の 4 つのパラメーターを設定する必要があります。フィールド名
説明
RoleArn
引き受ける RAM ロールの Alibaba Cloud リソースネーム (ARN)。これは RAM ロールからコピーします。
RoleSessionName
ロールセッションの名前。これは、監査のために異なるユーザーを区別するための、ユーザー ID や名前などの任意の文字列にすることができます。
DurationSeconds
トークンの有効期間。最小値は 900 秒、最大値は RAM ロールの最大セッション期間です。デフォルトは 3,600 秒です。
Policy
STS トークンの追加の権限ポリシー。
-
このポリシーを指定した場合、STS トークンの最終的な権限ポリシーは、RAM ロールの権限ポリシーとこのポリシーの共通部分になります。
-
このポリシーを指定しない場合、STS トークンの最終的な権限ポリシーは RAM ロールの権限ポリシーになります。
呼び出し時に、ユーザーごとに異なるポリシーを設定します。これにより、STS トークンに追加の権限ポリシーが追加されます。STS トークンの最終的な権限ポリシーは、RAM ロールの権限ポリシーとこのポリシーの共通部分になります。たとえば、ユーザー A が埋め込みページにアクセスするときは、RoleSessionName を
UserAに設定し、ポリシーを次のように設定します。{ "Version": "1", "Statement": [ { "Action": [ "log:Get*", "log:List*" ], "Resource": [ "acs:log:*:*:project/<Your Project Name A>/*", "acs:log:*:*:project/<Your Project Name A>" ], "Effect": "Allow" }, { "Effect": "Allow", "Action": "log:CreateTicket", "Resource": "acs:log:*:*:ticket/*" } ] }ユーザー B が埋め込みページにアクセスするときは、RoleSessionName を
UserBに設定し、ポリシーを次のように設定します。{ "Version": "1", "Statement": [ { "Action": [ "log:Get*", "log:List*" ], "Resource": [ "acs:log:*:*:project/<Your Project Name B>/*", "acs:log:*:*:project/<Your Project Name B>" ], "Effect": "Allow" }, { "Effect": "Allow", "Action": "log:CreateTicket", "Resource": "acs:log:*:*:ticket/*" } ] }一時的な STS 認証情報 (SecurityToken、AccessKeySecret、および AccessKeyId) を取得した後、この STS 認証情報を使用して CreateTicket を呼び出し、チケットを取得します。次の例では Java を使用します。
package com.aliyun.sls20201230; import com.aliyun.sls20201230.models.CreateTicketRequest; import com.aliyun.sls20201230.models.CreateTicketResponse; import com.aliyun.sls20201230.models.CreateTicketResponseBody; import com.aliyun.sts20150401.models.AssumeRoleResponse; import com.aliyun.sts20150401.models.AssumeRoleResponseBody; import com.aliyun.tea.TeaException; import com.aliyun.teaopenapi.models.Config; import java.util.List; public class StsSample { public static void main(String[] args_) throws Exception { List<String> args = java.util.Arrays.asList(args_); String roleArn = "xxxx"; String roleSession = "UserA"; String policy = "{\n" + " \"Version\": \"1\",\n" + " \"Statement\": [\n" + " {\n" + " \"Action\": [\n" + " \"log:Get*\",\n" + " \"log:List*\"\n" + " ],\n" + " \"Resource\": [\n" + " \"acs:log:*:*:project/<Your Project Name A>/*\",\n" + " \"acs:log:*:*:project/<Your Project Name A>\"\n" + " ],\n" + " \"Effect\": \"Allow\"\n" + " },\n" + " {\n" + " \"Effect\": \"Allow\",\n" + " \"Action\": \"log:CreateTicket\",\n" + " \"Resource\": \"acs:log:*:*:ticket/*\"\n" + " }\n" + " ]\n" + "}"; Client client = StsSample.createClient(roleArn, roleSession, policy); try { CreateTicketRequest createTicketRequest = new CreateTicketRequest(); CreateTicketResponse response = client.createTicket(createTicketRequest); CreateTicketResponseBody embedded = response.getBody(); System.out.println(embedded.getTicket()); } catch (TeaException e) { e.printStackTrace(); } } public static Client createClient(String roleArn, String roleSession, String policy) throws Exception { com.aliyun.sts20150401.Client client = createStsClient(); com.aliyun.sts20150401.models.AssumeRoleRequest assumeRoleRequest = new com.aliyun.sts20150401.models.AssumeRoleRequest(); assumeRoleRequest.setRoleArn(roleArn); assumeRoleRequest.setRoleSessionName(roleSession); assumeRoleRequest.setDurationSeconds(3600L); assumeRoleRequest.setPolicy(policy); com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions(); AssumeRoleResponse assumeRoleResponse = client.assumeRoleWithOptions(assumeRoleRequest, runtime); AssumeRoleResponseBody.AssumeRoleResponseBodyCredentials credentials = assumeRoleResponse.getBody().getCredentials(); Config config = new Config() .setAccessKeyId(credentials.getAccessKeyId()) .setAccessKeySecret(credentials.getAccessKeySecret()) .setSecurityToken(credentials.getSecurityToken()) // エンドポイントの詳細については、https://api.alibabacloud.com/product/Sls をご参照ください。 .setEndpoint("cn-shanghai.log.aliyuncs.com"); return new Client(config); } public static com.aliyun.sts20150401.Client createStsClient() throws Exception { String accessKeyId = "xxx"; String accessKeySecret = "xxx"; com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config() .setAccessKeyId(accessKeyId) .setAccessKeySecret(accessKeySecret); // エンドポイントの詳細については、https://api.alibabacloud.com/product/Sts をご参照ください。 config.endpoint = "sts.cn-shanghai.aliyuncs.com"; return new com.aliyun.sts20150401.Client(config); } } -
-
取得したチケットをクエリページの URL に追加します。サイドバーとトップバーを非表示にし、タブ履歴を無効にすることもできます (
hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true)。詳細については、「コンソールページの埋め込みに関するパラメーターの設定」をご参照ください。https://sls.console.alibabacloud.com/lognext/project/<Project name>/logsearch/<Logstore name>?slsRegion=<Project region>&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true&sls_ticket=eyJ***************.eyJ******************.KUT****************
複数の埋め込みページの権限設定
同一権限の複数埋め込みページ
-
1 つのチケットを生成し、同じブラウザでページを更新できます。チケットの有効期限が切れたら、新しいチケットを生成し、すべてのタブページで期限切れのチケットを置き換えます。
-
異なるブラウザまたはコンピューターは、異なるユーザーとして扱われます。チケットはブラウザでリンクを開く際に 1 回しか使用できないため、次のエラーが報告されます:
{"code":"TicketUnavailable","message":"There are no more tickets available.","requestId":"xxxxxx","success":false}
異なる権限の複数埋め込みページ
-
複数のチケットを生成し、それぞれに異なる権限を関連付けることができます。ただし、更新できるのは最後のチケットに対応する埋め込みページのみです。これは、現在のユーザーの認証情報として記録できるクッキーが 1 つしかなく、そのクッキーが最後に生成されたチケットに対応するためです。各更新では、このクッキーを使用して現在のユーザーを識別します。
-
ページを更新しない場合、クッキーは不要です。タブを切り替えて、各埋め込みページのコンテンツを対応する権限で操作できます。
-
最後のチケットに対応しない埋め込みページを更新すると、次のエラーが報告されます:
{"code":"TicketUnavailable","message":"There are no more tickets available.","requestId":"xxxxxx","success":false}
パスワードレス・ログイン不要リンクの生成 (旧バージョン)
次のレガシ メソッドも使用できますが、サードパーティ Cookie に依存するため、新しいメソッドよりも低速です:単一のパスワードレスかつログイン不要リンクの生成。このトピックの他のすべてのシナリオでは、新しいメソッドを使用します。
-
この機能は、RAM ロールを引き受けてアクセスする場合のみサポートします。
-
バックエンドの検証ロジックにより、ログイン不要ページを継続して使用するために、SigninToken の有効期限が切れる 5 分前にコンソール共有リンクを再生成することを推奨します。そうしない場合、SigninToken の有効期限が切れると、ログイン不要ページで "SigninToken" エラーが表示されます。
ステップ 1:RAM ロールと RAM ユーザーの作成
RAM ロールを作成し、共有ページの閲覧権限を付与します。次に、RAM ユーザーを作成し、RAM ロールを引き受ける権限を付与します。
-
現在の Alibaba Cloud アカウント配下の RAM ユーザーまたは別の RAM ロールが引き受け可能な RAM ロールを作成します。詳細については、「RAM ロールを使用して Alibaba Cloud アカウント間でリソースにアクセスする」をご参照ください。
-
RAM ロールに権限を付与し、共有リンクにアクセスできるようにします。たとえば、Simple Log Service (SLS) の読み取り専用権限を付与します。
{ "Version": "1", "Statement": [ { "Action": [ "log:Get*", "log:List*", "log:Query*" ], "Resource": "*", "Effect": "Allow" } ] } -
RAM ロールの ARN を記録します (例:
acs:ram::137******44:role/role-name)。 -
RAM ユーザーを作成するには、「RAM ユーザーの作成と権限付与」をご参照ください。ユーザーの作成時に、[OpenAPI コールアクセス]オプションを選択します。ユーザーの作成後、AccessKey ペアを記録します。
-
RAM ユーザーにロールを引き受ける権限を付与します。
説明Resource には、作成した RAM ロールの ARN を指定します。
{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": "sts:AssumeRole", "Resource": "acs:ram::137******44:role/role-name" } ] }
ステップ 2:共有可能なリンクの準備
-
クエリと分析ページ:
https://sls4service.console.alibabacloud.com/lognext/project/<Project name>/logsearch/<Logstore name>?slsRegion=<Project region>&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true -
クエリページ:
https://sls4service.console.alibabacloud.com/lognext/project/<Project name>/logsearch/<Logstore name>?slsRegion=<Project region>&isShare=true&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true
-
ダッシュボードページ:
https://sls4service.console.alibabacloud.com/lognext/project/<Project name>/dashboard/<Dashboard ID>?slsRegion=<Project region>&isShare=true&hideTopbar=true&hideSidebar=true&ignoreTabLocalStorage=true説明[Dashboard ID] は表示名ではなく、ダッシュボード URL 内の ID です。また、SLS コンソールの パスワードなしでダッシュボードを共有 機能を使用することもできます。
-
フルスタック可観測性アプリケーションページ
次の例では Trace Analysis ページを使用します。詳細については、「フルスタック可観測性ページを埋め込む」をご参照ください。
https://sls4service.console.alibabacloud.com/lognext/app/observability/trace/<Project name>/<Full-stack observability instance ID>?resource=/trace/<Full-stack observability instance ID>/explorer&hideTopbar=true&isShare=true
ステップ 3:ログイン不要リンクの生成
ログイン不要リンクを作成します。
-
RAM ユーザーの
AccessKeyを使用して STS サービスにアクセスし、STS トークンと交換します。トークンは 1 回のみ使用できます。トークンの有効期間を指定できます。次のコードは、STS トークンを取得する例を示しています。DefaultProfile.addEndpoint("", "", "Sts", stsHost); IClientProfile profile = DefaultProfile.getProfile("", <AccessKeyId>, <AccessKeySecret>); DefaultAcsClient client = new DefaultAcsClient(profile); AssumeRoleRequest assumeRoleReq = new AssumeRoleRequest(); assumeRoleReq.setRoleArn(roleArn); // RAM ロールの ARN assumeRoleReq.setRoleSessionName(roleSession); assumeRoleReq.setMethod(MethodType.POST); assumeRoleReq.setDurationSeconds(3600L); AssumeRoleResponse assumeRoleRes = client.getAcsResponse(assumeRoleReq); -
RAM シングルサインオン (SSO) を呼び出してログイン トークンを取得します。リンクの形式は次のとおりです。注:
TicketTypeはminiに設定する必要があります。http://signin.alibabacloud.com/federation?Action=GetSigninToken &AccessKeyId=<Temporary AK returned by STS> &AccessKeySecret=<Temporary secret returned by STS> &SecurityToken=<Security token returned by STS> &TicketType=mini返される構造は次のとおりです:
{ "RequestId": "02b47c77c5fd48789d23773af853e9f7_936be_1706585994094_1.229", "SigninToken": "svX6LGcBbWLExKD5hcwdLu6RsLQbv36fWZN36WhxkTXpTcDpmzs2K6X8uFvCqGsBTU4KWJMffYz2rAVbdJXHMECgUfyzS869wh2DBdFEQo3e2fJgZ5YtcMSVnoX7pterS2f7926jFvdBXVFEF54JkUCMrDAutNRv1u7ZReC7v8oQoG5UmjJBbHUyvLTn5UDDvDfNowMVyRskrZRFUKT2qAMZ4Gnc****" } -
取得したログイン トークンを準備したリンクに追加して、ログイン不要のアクセスリンクを生成します。
http://signin.alibabacloud.com/federation?Action=Login &LoginUrl=<ログオンが失敗した場合にユーザーがリダイレクトされる URL。通常、これは 302 リダイレクトを実行する独自の Web サーバー上の URL です。LoginUrl を URL エンコードする必要があります。> &Destination=<アクセスする実際の Simple Log Service ページ。クエリページとダッシュボードページがサポートされています。パラメーターがある場合は、それらを URL エンコードする必要があります。> &SigninToken=<取得したログイン トークン。トークンを URL エンコードする必要があります。>
ステップ 4:iframe を使用した埋め込み
iframe を使用して、リンクを別の Web ページに埋め込みます。
-
このテストとは、ブラウザでログイン不要リンクを初めて開く操作のことです。テスト後、ログイン トークンは無効になります。ログイン不要リンクを再生成する必要があります。
-
iframe 内のリンクでエラーが発生する場合、外部 Web サイトの読み込みを防ぐセキュリティ制限が原因である可能性があります。Content-Security-Policy ヘッダーを変更できます。たとえば、次の CSP ディレクティブを使用して、
aliyun.comおよび*.aliyun.comからの埋め込みを許可できます:Content-Security-Policy: frame-ancestors 'self' aliyun.com *.aliyun.com;
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Console Link Sharing</title>
</head>
<body>
<iframe width="1280" height="720" src="ログイン不要のアクセスリンク"> </iframe>
</body>
</html>