Git Gateway is a Netlify open source project that allows you to add editors to your site CMS without giving them direct write access to your GitHub or GitLab repository. (For Bitbucket repositories, use the Bitbucket backend instead.)
Git Gateway with Netlify
The Netlify Identity service can handle the authentication and provides a simple interface for user management. The Decap CMS featured templates are working examples of this backend.
To use it in your own project stored on GitHub or GitLab, follow these steps:
- Head over to the Netlify Identity docs and follow the steps to get started.
- Add the following lines to your Decap CMS
backend: name: git-gateway
Reconnect after Changing Repository Permissions
If you change ownership on your repository, or convert a repository from public to private, you may need to reconnect Git Gateway with proper permissions. Find further instructions in the Netlify Git Gateway docs.
Git Gateway without Netlify
You can use Git Gateway without Netlify by setting up your own Git Gateway server and connecting it with your own instance of GoTrue (the open source microservice that powers Netlify Identity), or with any other identity service that can issue JSON Web Tokens (JWT).
To configure in Decap CMS, use the same
backend settings in your Decap CMS
config.yml file as described in Step 2 of the Git Gateway with Netlify Identity instructions above.