Skip to main content

Schema Reference

Title: GitProxy configuration file

Typeobject
RequiredNo
Additional propertiesNot allowed

Description: Configuration for customizing git-proxy

1. [Optional] Property GitProxy configuration file > proxyUrl
Typestring
RequiredNo
2. [Optional] Property GitProxy configuration file > cookieSecret
Typestring
RequiredNo
3. [Optional] Property GitProxy configuration file > sessionMaxAgeHours
Typenumber
RequiredNo
4. [Optional] Property GitProxy configuration file > api
Typeobject
RequiredNo
Additional propertiesAny type allowed

Description: Third party APIs

5. [Optional] Property GitProxy configuration file > commitConfig
Typeobject
RequiredNo
Additional propertiesAny type allowed

Description: Enforce rules and patterns on commits including e-mail and message

6. [Optional] Property GitProxy configuration file > attestationConfig
Typeobject
RequiredNo
Additional propertiesAny type allowed

Description: Customisable questions to add to attestation form

7. [Optional] Property GitProxy configuration file > domains
Typeobject
RequiredNo
Additional propertiesAny type allowed

Description: Provide domains to use alternative to the defaults

8. [Optional] Property GitProxy configuration file > rateLimit
Typeobject
RequiredNo
Additional propertiesNot allowed

Description: API Rate limiting configuration.

8.1. [Required] Property GitProxy configuration file > rateLimit > windowMs
Typenumber
RequiredYes

Description: How long to remember requests for, in milliseconds (default 10 mins).

8.2. [Required] Property GitProxy configuration file > rateLimit > limit
Typenumber
RequiredYes

Description: How many requests to allow (default 150).

8.3. [Optional] Property GitProxy configuration file > rateLimit > statusCode
Typenumber
RequiredNo

Description: HTTP status code after limit is reached (default is 429).

8.4. [Optional] Property GitProxy configuration file > rateLimit > message
Typestring
RequiredNo

Description: Response to return after limit is reached.

9. [Optional] Property GitProxy configuration file > privateOrganizations
Typearray
RequiredNo

Description: Pattern searches for listed private organizations are disabled

10. [Optional] Property GitProxy configuration file > urlShortener
Typestring
RequiredNo

Description: Customisable URL shortener to share in proxy responses and warnings

11. [Optional] Property GitProxy configuration file > contactEmail
Typestring
RequiredNo

Description: Customisable e-mail address to share in proxy responses and warnings

12. [Optional] Property GitProxy configuration file > csrfProtection
Typeboolean
RequiredNo

Description: Flag to enable CSRF protections for UI

13. [Optional] Property GitProxy configuration file > plugins
Typearray of string
RequiredNo

Description: List of plugins to integrate on GitProxy's push or pull actions. Each value is either a file path or a module name.

Each item of this array must beDescription
plugins items-

13.1. GitProxy configuration file > plugins > plugins items

Typestring
RequiredNo
14. [Optional] Property GitProxy configuration file > authorisedList
Typearray
RequiredNo

Description: List of repositories that are authorised to be pushed to through the proxy.

Each item of this array must beDescription
authorisedRepo-

14.1. GitProxy configuration file > authorisedList > authorisedRepo

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/definitions/authorisedRepo
14.1.1. [Required] Property GitProxy configuration file > authorisedList > authorisedList items > project
Typestring
RequiredYes
14.1.2. [Required] Property GitProxy configuration file > authorisedList > authorisedList items > name
Typestring
RequiredYes
14.1.3. [Required] Property GitProxy configuration file > authorisedList > authorisedList items > url
Typestring
RequiredYes
15. [Optional] Property GitProxy configuration file > sink
Typearray
RequiredNo

Description: List of database sources. The first source in the configuration with enabled=true will be used.

Each item of this array must beDescription
database-

15.1. GitProxy configuration file > sink > database

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/definitions/database
15.1.1. [Required] Property GitProxy configuration file > sink > sink items > type
Typestring
RequiredYes
15.1.2. [Required] Property GitProxy configuration file > sink > sink items > enabled
Typeboolean
RequiredYes
15.1.3. [Optional] Property GitProxy configuration file > sink > sink items > connectionString
Typestring
RequiredNo
15.1.4. [Optional] Property GitProxy configuration file > sink > sink items > options
Typeobject
RequiredNo
Additional propertiesAny type allowed
15.1.5. [Optional] Property GitProxy configuration file > sink > sink items > params
Typeobject
RequiredNo
Additional propertiesAny type allowed
16. [Optional] Property GitProxy configuration file > authentication
Typearray
RequiredNo

Description: List of authentication sources. The first source in the configuration with enabled=true will be used.

Each item of this array must beDescription
authentication-

16.1. GitProxy configuration file > authentication > authentication

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/definitions/authentication
16.1.1. [Required] Property GitProxy configuration file > authentication > authentication items > type
Typestring
RequiredYes
16.1.2. [Required] Property GitProxy configuration file > authentication > authentication items > enabled
Typeboolean
RequiredYes
16.1.3. [Optional] Property GitProxy configuration file > authentication > authentication items > options
Typeobject
RequiredNo
Additional propertiesAny type allowed
17. [Optional] Property GitProxy configuration file > tempPassword
Typeobject
RequiredNo
Additional propertiesAny type allowed

Description: Toggle the generation of temporary password for git-proxy admin user

17.1. [Optional] Property GitProxy configuration file > tempPassword > sendEmail
Typeboolean
RequiredNo
17.2. [Optional] Property GitProxy configuration file > tempPassword > emailConfig
Typeobject
RequiredNo
Additional propertiesAny type allowed

Description: Generic object to configure nodemailer. For full type information, please see https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/nodemailer

18. [Optional] Property GitProxy configuration file > tls
Typeobject
RequiredNo
Additional propertiesAny type allowed

Description: TLS configuration for secure connections

18.1. [Required] Property GitProxy configuration file > tls > enabled
Typeboolean
RequiredYes
18.2. [Required] Property GitProxy configuration file > tls > key
Typestring
RequiredYes
18.3. [Required] Property GitProxy configuration file > tls > cert
Typestring
RequiredYes

Generated using json-schema-for-humans on 2025-05-01 at 18:17:32 +0100

  • 13.1. GitProxy configuration file > plugins > plugins items
  • 14.1. GitProxy configuration file > authorisedList > authorisedRepo
  • 15.1. GitProxy configuration file > sink > database
  • 16.1. GitProxy configuration file > authentication > authentication