From 51bb596f0852a2fcd937c0021bb6b0875a484c13 Mon Sep 17 00:00:00 2001
From: Christian Ihle <blurpy@gmail.com>
Date: Wed, 18 Jan 2023 10:02:44 +0100
Subject: [PATCH] Document support for bearer token authentication over https
 in gitrepositories

Signed-off-by: Christian Ihle <blurpy@gmail.com>
---
 docs/spec/v1beta2/gitrepositories.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/spec/v1beta2/gitrepositories.md b/docs/spec/v1beta2/gitrepositories.md
index 55c84f6bf..a56ecd196 100644
--- a/docs/spec/v1beta2/gitrepositories.md
+++ b/docs/spec/v1beta2/gitrepositories.md
@@ -131,6 +131,23 @@ data:
   password: <BASE64>
 ```
 
+#### Bearer token authentication
+
+To authenticate towards a Git repository over HTTPS using bearer token
+authentication (in other words: using a `Authorization: Bearer` header), the referenced
+Secret is expected to contain the token in `.data.bearerToken`.
+
+```yaml
+---
+apiVersion: v1
+kind: Secret
+metadata:
+  name: bearer-token-auth
+type: Opaque
+data:
+  bearerToken: <BASE64>
+```
+
 #### HTTPS Certificate Authority
 
 To provide a Certificate Authority to trust while connecting with a Git