Токен для Digital Garden plugin

Fine-grained token нужен, чтобы Obsidian Digital Garden plugin мог отправлять опубликованные заметки в GitHub repo от имени сотрудника.

Токен — это секретный ключ доступа. Его значение должно оставаться только в настройках plugin.

Что должно быть готово

От админа должны быть:

GitHub owner: ...
Repository name: ...
Branch: ...

И должен быть принят GitHub invite: Настройка GitHub-доступа.

Какие права выбрать

Базовая безопасная настройка:

Resource owner: owner, который дал админ
Repository access: Only selected repositories
Selected repositories: только garden repo
Repository permissions: Contents — Read and write

Остальные permissions не включать, если админ отдельно не попросил.

Как создать token

Открой GitHub.
Перейди в настройки аккаунта.
Открой Developer settings.
Открой Personal access tokens.
Выбери Fine-grained tokens.
Нажми Generate new token.
Назови token понятно, например Duck Garden - <garden-name>.
Поставь срок действия.
В Resource owner выбери owner, который дал админ.
В Repository access выбери только нужный garden repo.
В Repository permissions включи Contents: Read and write.
Создай token.
Скопируй token сразу и вставь его только в Digital Garden plugin.

GitHub показывает token только один раз. Если token потерян, проще удалить его и создать новый.

Куда вставлять token

Token вставляется только в настройки Digital Garden plugin в Obsidian.

См. Настройка Digital Garden plugin.

Что отправить админу

Отправить только статус:

Fine-grained token создан: да
Token вставлен в plugin: да

Когда пересоздавать token

Token нужно пересоздать, если он истёк, был случайно раскрыт, сотрудник больше не работает с этим garden или plugin показывает ошибку доступа.

Подробнее: Безопасность токена и доступов.