永久トークンの管理
YouTrack クラウドでは、永久トークンにより、開発者は OAuth 2.0 認証フローを実装しなくても、スクリプトとアプリケーションで RESTAPI 呼び出しを使用して安全に操作にアクセスして実行できます。永久トークンは、ユーザーアカウントに付与されたアクセス許可を持つサービスへのアクセスを許可します。
このページでは、ユーザープロファイルで実行される永久トークンを使用した操作について説明します。永久トークンを使用した RESTAPI 呼び出しのサンプルについては、永久トークン認証を参照してください。
永久トークンを作成する
ユーザーアカウントに付与されているアクセス許可を使用してプログラムでサービスにアクセスするには、独自の永久トークンを作成します。
ここにリストされている権限に加えて、トークンを使用してアクセスするサービスを読み取るための権限が必要です。接続されたサービスへのアクセスは Hub で管理されます。YouTrack クラウドまたは組み込みの Hub サービスを使用する YouTrack サーバーのインストールを使用している場合、すべてのユーザーが YouTrack サービスにアクセスできます。
新しい永久トークンを生成するには:
メインナビゲーションメニューからアバターを選択し、プロファイルを選択します。
アカウントのセキュリティタブを選択します。
ページのトークンセクションで、新規トークンボタンをクリックします。
新しい永久トークンダイアログで、新しいトークンの名前とアクセススコープを指定します。トークンのスコープとは、この新しいトークンでアクセスできるサービスのリストです。
次の表の情報を使用して、トークンを割り当てるスコープを決定します。
スコープ
説明
YouTrack
YouTrack の課題、タグ、コマンド、アジャイルボード、ダッシュボード、レポート、その他の基本操作を実行する権限を付与します。
このスコープでは、次のエンドポイントに REST API 呼び出しを送信することもできるようになります。
/youtrack/rest/.../youtrack/api/...
YouTrack の管理
ユーザーアクセスを管理し、サーバー設定を更新する権限を付与します。
このスコープでは、次のエンドポイントに REST API 呼び出しを送信することもできるようになります。
/hub/api/.../hub/rest/...
コネクター
YouTrack の Konnector サービスに統合されたメッセージングアプリに情報を送信する権限を付与します。これには Slack 用 YouTrack アプリと Telegram の YouTrack ボットが含まれます。
YouTrack モバイル
YouTrack モバイルアプリにプッシュ通知を送信する権限を付与します。
トークンを作成ボタンをクリックしてください。
新しいトークンを含むダイアログウィンドウが表示されます。
トークンをコピーするには、次の 2 つのアクションのいずれかを使用します。
トークンをコピーボタンをクリックしてください。
ポインターでトークンを選択し、オペレーティングシステムの標準キーボードショートカットを使用して、現在の選択をクリップボードにコピーします。
トークンをコピーしたら、ダイアログを閉じます。
新しいトークンはユーザーアカウントに関連付けられ、トークンリストに表示されます。
永久トークンを削除する
永久トークンには有効期限はありません。認証されたサービスが侵害された疑いがある場合は、プロファイル内のこのトークンを明示的に削除できます。
永久トークンを削除するには
メインナビゲーションメニューからアバターを選択し、プロファイルを選択します。
アカウントのセキュリティタブを選択します。
トークンのリストで、取り消したいトークンを選択します。
削除ボタンをクリックしてください。
確認ダイアログが表示されます。
削除ボタンをクリックして操作を確定します。
選択した永久トークンが削除され、リストから削除されます。
関連ページ：
永久トークン認証
永続的なトークンはあなたのクライアントアプリケーションとスクリプトから YouTrack への安全なアクセスをあなたに与えます。OAuth 2.0 と比較して、恒久的なトークンによる認証には次の利点があります。安全なトークンベースの認証 — アクセストークンを取得するための複雑な OAuth2.0 承認フローを実装せずにアクセスを承認します。簡単な管理 — ユーザープロファイルに独自の永久トークンを作成します。接続が侵害された疑いがある場合は、いつでもトークンを削除して、新しいトークンを生成できます...
Slack 用 YouTrack アプリ
Slack 用の YouTrack アプリを使用すると、YouTrack と Slack ワークスペースをリンクして、両方のアプリケーションを最大限に活用できます。ユーザーは、YouTrack 通知をメールから Slack に転送し、すべての YouTrack 更新をダイレクトメッセージとして表示できます。この機能の簡単なセットアップガイドについては、この短いビデオを参照してください。YouTrack アプリは、Slack の課題へのリンクを投稿したユーザーが、他のユーザーにコンテンツを表示する...
Telegram 用 YouTrack ボット
Telegram の YouTrack ボットを使用すると、ユーザーは Telegram メッセージングアプリから課題や記事を直接操作できます。YouTrack インストールでこの機能を有効にすると、次の機能が誰でも使用できるようになります。リンクのプレビュー YouTrack ボットは、ユーザーが公開課題または記事にリンクを投稿するとプレビューを表示します。これにより、他のユーザーは Telegram でコンテンツを直接表示し、プレビューから必要な情報をすべて取得するか、リンクをクリックする必要...
パスワードの管理
ログインして YouTrack を操作する機能は、さまざまな認証モジュールを使用して管理されます。YouTrack で使用されるデフォルトの認証モジュールは、組み込みの Hub サービスによって提供されます。YouTrack は、外部認証プロバイダーによって管理される資格情報を保管するように構成することもできます。例: ユーザーが自分の Google アカウントでログインできるように設定できます。この場合にパスワードを更新するには、サードパーティのサービスにログインしてパスワードを変更するだけで...
アプリケーションパスワードを生成する
アカウントで二要素認証を有効にすると、認証にアカウントを使用するサードパーティアプリにログインするときに課題が発生することがあります。ほとんどの場合、アプリは 2 要素認証コードの入力を求めるようには構築されていません。認証サービスではコードなしではログインできないため、「パスワードが正しくありません」などの一般的なエラーが表示される可能性があります。認証コードなしでログインするには、アプリケーションパスワードを使用します。アプリケーションパスワードは、YouTrack アカウントにアクセスする...