mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-22 12:35:51 +00:00
d4f8d0918a
Related to https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/3841 Most of the preparation for this was done by Suguru Hirahara (https://github.com/luixxiul). I've merely reorganized/polished the scripts and instructions in the `i18n/` directory. While translations can happen even now, more work is necessary to - make the translation flow better (integrating Weblate), etc. - restore the Github Actions workflows that Suguru Hirahara had already developed to adapt them to our new workflow
94 lines
3.7 KiB
Plaintext
94 lines
3.7 KiB
Plaintext
# 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 <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2024-12-20 07:23+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\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 ""
|