24 lines
1.2 KiB
Markdown
24 lines
1.2 KiB
Markdown
|
# Personal Access Tokens
|
||
|
|
## Assumptions
|
||
|
|
* [Git installed](https://git-scm.com/downloads)
|
||
|
|
* [Skynet / Forgejo account](https://forgejo.skynet.ie/user/login)
|
||
|
|
|
||
|
|
### Why
|
||
|
|
The usual way of authentication when working with remote git repositories
|
||
|
|
is SSH, unfortunately we aren't able to do that with our git server. You could use username and password
|
||
|
|
however that is less secure and inconvenient, personal access tokens on the other hand are a more convenient and secure alternative.
|
||
|
|
|
||
|
|
Personal access tokens make it so you don't have to use username / password
|
||
|
|
to authenticate, you can authenticate **once** when **cloning** and that's it.
|
||
|
|
### How
|
||
|
|
Go to [this page and click generate token](https://forgejo.skynet.ie/user/settings/applications)
|
||
|
|
Give it a name and select read and write for repository permissions
|
||
|
|
Copy it once its generated
|
||
|
|
|
||
|
|
**Note : Do not share your access token with anyone, if its compromised delete it, this can be done easily
|
||
|
|
[here](https://forgejo.skynet.ie/user/settings/applications) and prevents it from being used.**
|
||
|
|
|
||
|
|
When cloning a repository, use the token like so..
|
||
|
|
```git clone https://<token>@forgejo.skynet.ie/<repo>```
|
||
|
|
|
||
|
|
You now should be able to push to the repository without being prompted for username / password.
|