gitea/docs/content/doc/administration
Leon Busch-George 7a8a4f5432
Prefer native parser for SSH public key parsing (#23798)
Without this patch, the setting SSH.StartBuiltinServer decides whether
the native (Go) implementation is used rather than calling 'ssh-keygen'.
It's possible for 'using ssh-keygen' and 'using the built-in server' to
be independent.
In fact, the gitea rootless container doesn't ship ssh-keygen and can be
configured to use the host's SSH server - which will cause the public
key parsing mechanism to break.

This commit changes the decision to be based on SSH.KeygenPath instead.
Any existing configurations with a custom KeygenPath set will continue
to function. The new default value of '' selects the native version. The
downside of this approach is that anyone who has relying on plain
'ssh-keygen' to have special properties will now be using the native
version instead.
I assume the exec-variant is only there because /x/crypto/ssh didn't
support ssh-ed25519 until 2016. I don't see any other reason for using
it so it might be an acceptable risk.

Fixes #23363

EDIT: this message was garbled when I tried to get the commit
description back in.. Trying to reconstruct it:

## ⚠️ BREAKING ⚠️ Users who don't have SSH.KeygenPath
explicitly set and rely on the ssh-keygen binary need to set
SSH.KeygenPath to 'ssh-keygen' in order to be able to continue using it
for public key parsing.

There was something else but I can't remember at the moment.

EDIT2: It was about `make test` and `make lint`. Can't get them to run.
To reproduce the issue, I installed `golang` in `docker.io/node:16` and
got:
```
...
go: mvdan.cc/xurls/v2@v2.4.0: unknown revision mvdan.cc/xurls/v2.4.0
go: gotest.tools/v3@v3.4.0: unknown revision gotest.tools/v3.4.0
...
go: gotest.tools/v3@v3.0.3: unknown revision gotest.tools/v3.0.3
...
go: error loading module requirements
```

Signed-off-by: Leon M. Busch-George <leon@georgemail.eu>
2023-04-11 14:34:28 +08:00
..
adding-legal-pages.en-us.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
backup-and-restore.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
backup-and-restore.zh-cn.md Restructure documentation. Now the documentation has installation, administration, usage, development, contributing the 5 main parts (#23629) 2023-03-23 23:18:24 +08:00
backup-and-restore.zh-tw.md Restructure documentation. Now the documentation has installation, administration, usage, development, contributing the 5 main parts (#23629) 2023-03-23 23:18:24 +08:00
cmd-embedded.en-us.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
command-line.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
config-cheat-sheet.en-us.md Prefer native parser for SSH public key parsing (#23798) 2023-04-11 14:34:28 +08:00
config-cheat-sheet.zh-cn.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
customizing-gitea.en-us.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
customizing-gitea.zh-cn.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
email-setup.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
environment-variables.en-us.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
environment-variables.zh-cn.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
external-renderers.en-us.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
fail2ban-setup.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
fail2ban-setup.zh-cn.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
git-lfs-support.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
https-support.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
https-support.zh-cn.md Fix markdownlint (#24024) 2023-04-09 14:39:37 -04:00
logging-documentation.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
mail-templates.en-us.md docs: fix typo (#23924) 2023-04-04 11:22:45 -04:00
repo-indexer.en-us.md Restructure documentation. Now the documentation has installation, administration, usage, development, contributing the 5 main parts (#23629) 2023-03-23 23:18:24 +08:00
reverse-proxies.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
reverse-proxies.zh-cn.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00
search-engines-indexation.en-us.md Adjust some documentations titles (#23941) 2023-04-06 11:06:32 +02:00
signing.en-us.md Update docs markdown file weight to make it clear (#23909) 2023-04-04 21:47:31 +08:00