# SOME DESCRIPTIVE TITLE. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community # members # This file is distributed under the same license as the # matrix-docker-ansible-deploy package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-12-16 12:05+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" "Language-Team: jp \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.16.0\n" #: ../../../docs/obtaining-access-tokens.md:1 msgid "Obtaining an Access Token" msgstr "" #: ../../../docs/obtaining-access-tokens.md:3 msgid "" "When setting up some optional features like bots and bridges you will " "need to provide an access token for some user. This document provides " "documentation on how to obtain such an access token." msgstr "" #: ../../../docs/obtaining-access-tokens.md:5 msgid "" "**Access tokens are sensitive information. Do not include them in any bug" " reports, messages, or logs. Do not share the access token with anyone.**" msgstr "" #: ../../../docs/obtaining-access-tokens.md:7 msgid "Prerequisites" msgstr "" #: ../../../docs/obtaining-access-tokens.md:9 msgid "" "The user for whom you want to obtain an access token needs to already " "exist. You can use this playbook to [register a new user](registering-" "users.md), if you have not already." msgstr "" #: ../../../docs/obtaining-access-tokens.md:11 msgid "" "Below, we describe 2 ways to generate an access token for a user - using " "[Element Web](#obtain-an-access-token-via-element-web) or [curl](#obtain-" "an-access-token-via-curl). For both ways you need the user's password." msgstr "" #: ../../../docs/obtaining-access-tokens.md:13 msgid "Obtain an access token via Element Web" msgstr "" #: ../../../docs/obtaining-access-tokens.md:15 msgid "In a private browsing session (incognito window), open Element Web." msgstr "" #: ../../../docs/obtaining-access-tokens.md:16 msgid "Log in with the user's credentials." msgstr "" #: ../../../docs/obtaining-access-tokens.md:17 msgid "" "In the settings page, choose \"Help & About\", scroll down to the bottom " "and expand the `Access Token` section (see screenshot below)." msgstr "" #: ../../../docs/obtaining-access-tokens.md:18 msgid "Copy the access token to your configuration." msgstr "" #: ../../../docs/obtaining-access-tokens.md:19 msgid "" "Close the private browsing session. **Do not log out**. Logging out will " "invalidate the token, making it not work." msgstr "" #: ../../../docs/obtaining-access-tokens.md:21 msgid "" "![Obtaining an access token with Element " "Web](assets/obtain_admin_access_token_element_web.png)" msgstr "" #: ../../../docs/obtaining-access-tokens.md:21 msgid "Obtaining an access token with Element Web" msgstr "" #: ../../../docs/obtaining-access-tokens.md:23 msgid "Obtain an access token via curl" msgstr "" #: ../../../docs/obtaining-access-tokens.md:25 msgid "" "You can use the following command to get an access token for your user " "directly from the [Matrix Client-Server " "API](https://www.matrix.org/docs/guides/client-server-api#login):" msgstr "" #: ../../../docs/obtaining-access-tokens.md:35 msgid "Change `USERNAME`, `PASSWORD`, and `example.com` accordingly." msgstr "" #: ../../../docs/obtaining-access-tokens.md:37 msgid "" "`YOURDEVICEID` is optional and can be used to more easily identify the " "session later. When omitted (mind the commas in the JSON payload if " "you'll be omitting it), a random device ID will be generated." msgstr "" #: ../../../docs/obtaining-access-tokens.md:39 msgid "Your response will look like this (prettified):" msgstr ""