GITOLFS3-AUTHENTICATE

NAME

gitolfs3-authenticate − Git LFS authentication agent for Gitolfs3

SYNOPSIS

gitolfs3-authenticate <repository> upload/download

DESCRIPTION

gitolfs3-authenticate is a Git LFS authentication agent for Gitolfs3. When accessible from the Git shell as git-lfs-authenticate, gitolfs3-authenticate can authorize users to access the Gitolfs3 Git LFS server.

Although gitolfs3-authenticate does assume that the user can be trusted, as they have access to the server, it is a good idea to restrict the shell for the git user. For example, the user should not be able to modify environment variables, nor should the user be able to execute any arbitrary command. The Git shell provided by Gitolfs3 may be a good option. (See gitolfs3-shell(1).)

ENVIRONMENT VARIABLES

GITOLFS3_HREF_BASE

Required. The base URL at which the Gitolfs3 server is available. Must end with a slash.

GITOLFS3_KEY_PATH

Required. The path to the key which is used to authorize the request to the Gitolfs3 server. The key must be 128-character hexadecimal string, i.e., a 64-byte number. Such a key can, for example, be generated using OpenSSL, with the following command:

openssl rand -hex 64

Note that the Gitolfs3 server must be configured to use exactly the same key for gitolfs3-authenticate to function.