TOKEN_FOR_GITEA_WIKI is an optional key, checked and masked but never used or asked for, so one .env can serve the wiki publishing too. GITHUB_PAT and GITHUB_USER are documented as required only when GitHub is chosen. The how-to for creating the access tokens moves from howto/ to the wiki as AccessTokens in English, Danish and Bahasa Malaysia, with its pictures in wiki/img/. README, Home and the sidebar link to it. Adds MIL-010 with its review RC-033 and the matching plan, user story and traceability rows. Task: MIL-010#1 Task: MIL-010#2 Task: MIL-010#3 Closes #83 Closes #84 Closes #85
33 lines
1.8 KiB
Markdown
33 lines
1.8 KiB
Markdown
<!-- translation of SshAndTokens.md, source sha256 ec9001c0248b -->
|
|
|
|
> Ini ialah terjemahan [`SshAndTokens`](SshAndTokens). Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
|
|
|
|
[English](SshAndTokens) | [Dansk](SshAndTokens.da) | Bahasa Melayu
|
|
|
|
# SSH dan token
|
|
|
|
## Akses SSH ke Gitea
|
|
|
|
Submodul framework diambil melalui SSH pada port **10022**. Sebelum anda menjalankan skrip:
|
|
|
|
1. Tambahkan kunci awam SSH anda ke akaun Gitea anda.
|
|
2. Sambung sekali secara manual supaya kunci hos pelayan dikenali (skrip menolak kunci hos yang tidak dikenali):
|
|
|
|
```bash
|
|
ssh -p 10022 -T git@git.tirsystem.com
|
|
```
|
|
|
|
Mesej bahawa anda telah berjaya disahkan, tanpa akses shell, bermakna ia berfungsi.
|
|
|
|
> **Kunci dengan frasa laluan.** Skrip tidak pernah meminta frasa laluan. Kunci dengan frasa laluan mesti sudah dimuatkan dalam `ssh-agent` (`ssh-add`). Perkara ini dijejaki dalam [issue 77](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/issues/77).
|
|
|
|
## Token
|
|
|
|
| Token | Kunci dalam `.env` | Diperlukan | Jenis |
|
|
| --- | --- | --- | --- |
|
|
| Token akses Gitea | `GITEA_TOKEN` | sentiasa | token akses dengan skop |
|
|
| GitHub personal access token | `GITHUB_PAT` | diperlukan apabila anda memilih GitHub (cermin) | personal access token **klasik** |
|
|
| Token akses Gitea untuk wiki | `TOKEN_FOR_GITEA_WIKI` | pilihan (hanya untuk menerbitkan wiki) | token akses dengan skop tulis repositori sahaja (`write:repository`); skrip menerimanya tetapi tidak pernah menggunakannya |
|
|
|
|
Langkah demi langkah dengan gambar: [cara mencipta token akses](AccessTokens.ms). Kebenaran yang tepat terdapat di bawah [Token permissions](https://git.tirsystem.com/TirSystem-BashScript/repo-foundry/src/branch/main/README.md#token-permissions) dalam README.
|