···7777See the [AtomicXR Homebrew Tap](https://tangled.sh/@matrixfurry.com/homebrew-atomicxr) for a list of plugins you can install.
78787979## Security ##
8080-Please report security issues via [SimpleX](https://smp18.simplex.im/a#Wc2x2IBqqwzgmeGkN0XtKrGMLBxFuxmoYgkTGgGgR0M) or [Email](mailto:shiloh@shilohfen.com).
81808282-> If you want to send an encrypted email, my public key fingerprint is [DD7EB0BAA822169398828C45103DD5193B6A77CB](https://keys.openpgp.org/vks/v1/by-fingerprint/DD7EB0BAA822169398828C45103DD5193B6A77CB).
8383-8484-Do not report security issues on the issue tracker.
8181+See [@matrixfurry.com/SECURITY.md](https://tangled.org/strings/@matrixfurry.com/3m2igb2euyh22) or [SECURITY.md](./SECURITY.md).
85828683## Support ##
8784
+65
SECURITY.md
···11+For the most up-to-date policy, please see [@matrixfurry.com/SECURITY.md](https://tangled.org/strings/@matrixfurry.com/3m2igb2euyh22).
22+33+# Reporting
44+Please report security issues via [SimpleX](https://smp18.simplex.im/a#Wc2x2IBqqwzgmeGkN0XtKrGMLBxFuxmoYgkTGgGgR0M) or [Email](mailto:shiloh@shilohfen.com).
55+66+> If you want to send an encrypted email, my public key fingerprint is [DD7EB0BAA822169398828C45103DD5193B6A77CB](https://keys.openpgp.org/vks/v1/by-fingerprint/DD7EB0BAA822169398828C45103DD5193B6A77CB).
77+88+Please do not report security issues on the project's issue tracker.
99+1010+# Commit signing
1111+1212+Commit signing is optional but highly recommended. Once you make your first signed commit, all future commits must be signed.
1313+1414+SSH signing is preferred over PGP signing.
1515+1616+To enable signature verification, add your public key to your Tangled profile, and optionally the `.allowed_signers` file in the project's repo.
1717+1818+## Setup
1919+Replace `<YOUR_KEY>` with the SSH key or keyfile you'd like to use (eg. `~/.ssh/id_ed25519`).
2020+2121+Git:
2222+```sh
2323+git config --global gpg.format ssh
2424+git config --global user.signingkey <YOUR_KEY>
2525+git config --global commit.gpgsign true
2626+```
2727+2828+Jujutsu:
2929+```sh
3030+jj config set --user signing.behavior own
3131+jj config set --user signing.backend ssh
3232+jj config set --user signing.key <YOUR_KEY>
3333+```
3434+3535+Add the public key to your Tangled profile at https://tangled.org/settings/keys
3636+3737+Optionally, add your public key to the repo's `.allowed_signers` file:
3838+- Git: `echo "$(git config user.email) $(cat ~/.ssh/id_ed25519.pub)" >> .allowed_signers`
3939+- Jujutsu: `echo "$(jj config get user.email) $(cat ~/.ssh/id_ed25519.pub)" >> .allowed_signers`
4040+4141+## Key Revocation
4242+Revoked keys are listed in `.revoked_keys` ([OpenSSH KRL](https://man.openbsd.org/ssh-keygen.1#KEY_REVOCATION_LISTS) format). Keys must never be reinstated or removed from this file. After a revocation, you must create a new key to continue contributing to the project.
4343+4444+A key revocation must be signed by either:
4545+1. The key being revoked
4646+ - Anyone with access to the private key can create the revocation commit
4747+4848+2. A maintainer with proof of compromise
4949+ - The maintainer must have significant evidence that the key has been compromised
5050+ - The maintainer must attempt to reach out to the contributor to confirm
5151+ - The commit message must provide details of why the key is being revoked
5252+5353+### Instructions
5454+5555+Add the key to the `.revoked_keys` file:
5656+```sh
5757+ssh-keygen -k -u -f .revoked_keys <PUBKEY.pub>
5858+```
5959+6060+View the revoked keys:
6161+```sh
6262+ssh-keygen -Q -l -f .revoked_keys
6363+```
6464+6565+For more information, see the [ssh-keygen(1) manpage](https://man.openbsd.org/ssh-keygen.1#k)