You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -46,7 +46,7 @@ To use GCM Core, you can download the [latest installer](https://github.com/Micr
46
46
47
47
### Git Credential Manager for Mac and Linux (Java-based GCM)
48
48
49
-
If you have an existing installation of the 'Java GCM' on macOS and you have installed this using Homebrew, this installation will be unlinked (`brew unlink git-credential-manager`) when GCM Core is installed. Additionally any symlinks or files previously located at `/usr/local/bin/git-credential-manager` will be replaced with a GCM Core symlink.
49
+
If you have an existing installation of the 'Java GCM' on macOS and you have installed this using Homebrew, this installation will be unlinked (`brew unlink git-credential-manager`) when GCM Core is installed.
Copy file name to clipboardExpand all lines: docs/configuration.md
+88-1Lines changed: 88 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,4 +22,91 @@ For the complete list of settings GCM Core understands, see the list below.
22
22
23
23
## Available settings
24
24
25
-
_Currently there are no available settings. This is a placeholder for the settings on the backlog._
25
+
### credential.provider
26
+
27
+
Define the host provider to use when authenticating.
28
+
29
+
ID|Provider
30
+
-|-
31
+
`auto`_(default)_|_\[automatic\]_
32
+
`azure-repos`|Azure Repos
33
+
`github`|GitHub
34
+
`generic`|Generic (any other provider not listed above)
35
+
36
+
Automatic provider selection is based on the remote URL.
37
+
38
+
This setting is typically used with a scoped URL to map a particular set of remote URLs to providers, for example to mark a host as a GitHub Enterprise instance.
Allow detection of Windows Integrated Authentication (WIA) support for generic host providers. Setting this value to `false` will prevent the use of WIA and force a basic authentication prompt when using the Generic host provider.
78
+
79
+
**Note:** WIA is only supported on Windows.
80
+
81
+
**Note:** WIA is an umbrella term for NTLM and Kerberos (and Negotiate).
> This setting is deprecated and should be replaced by the [standard `http.proxy` Git configuration option](https://git-scm.com/docs/git-config#Documentation/git-config.txt-httpproxy).
101
+
>
102
+
> Click [here](https://aka.ms/gcmcore-httpproxy) for more information.
103
+
104
+
Configure GCM Core to use the a proxy for network operations.
105
+
106
+
**Note:** Git itself does _not_ respect this setting; this affects GCM _only_.
Copy file name to clipboardExpand all lines: docs/environment.md
+129Lines changed: 129 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,6 +37,8 @@ Defaults to tracing disabled.
37
37
38
38
_No configuration equivalent._
39
39
40
+
---
41
+
40
42
### GCM_TRACE_SECRETS
41
43
42
44
Enables tracing of secret and senstive information, which is by default masked in trace output.
@@ -64,6 +66,8 @@ Defaults to disabled.
64
66
65
67
_No configuration equivalent._
66
68
69
+
---
70
+
67
71
### GCM_TRACE_MSAUTH
68
72
69
73
Enables inclusion of Microsoft Authentication libraries (ADAL, MSAL) logs in GCM trace output.
@@ -91,6 +95,8 @@ Defaults to disabled.
91
95
92
96
_No configuration equivalent._
93
97
98
+
---
99
+
94
100
### GCM_DEBUG
95
101
96
102
Pauses execution of GCM Core at launch to wait for a debugger to be attached.
@@ -112,3 +118,126 @@ export GCM_DEBUG=1
112
118
Defaults to disabled.
113
119
114
120
_No configuration equivalent._
121
+
122
+
---
123
+
124
+
### GCM_PROVIDER
125
+
126
+
Define the host provider to use when authenticating.
127
+
128
+
ID|Provider
129
+
-|-
130
+
`auto`_(default)_|_\[automatic\]_
131
+
`azure-repos`|Azure Repos
132
+
`github`|GitHub
133
+
`generic`|Generic (any other provider not listed above)
134
+
135
+
Automatic provider selection is based on the remote URL.
136
+
137
+
This setting is typically used with a scoped URL to map a particular set of remote URLs to providers, for example to mark a host as a GitHub Enterprise instance.
Allow detection of Windows Integrated Authentication (WIA) support for generic host providers. Setting this value to `false` will prevent the use of WIA and force a basic authentication prompt when using the Generic host provider.
193
+
194
+
**Note:** WIA is only supported on Windows.
195
+
196
+
**Note:** WIA is an umbrella term for NTLM and Kerberos (and Negotiate).
> This setting is deprecated and should be replaced by the [standard `http.proxy` Git configuration option](https://git-scm.com/docs/git-config#Documentation/git-config.txt-httpproxy).
224
+
>
225
+
> Click [here](https://aka.ms/gcmcore-httpproxy) for more information.
226
+
227
+
Configure GCM Core to use the a proxy for network operations.
228
+
229
+
**Note:** Git itself does _not_ respect this setting; this affects GCM _only_.
## Migrating from Git Credential Manager for Windows
4
+
5
+
### GCM_AUTHORITY
6
+
7
+
This setting (and the corresponding `credential.authority` configuration) is deprecated and should be replaced with the `GCM_PROVIDER` (or corresponding `credential.authority` configuration) setting.
8
+
9
+
Because both Basic HTTP authentication and Windows Integrated Authentication (WIA) are now handled by one provider, if you specified `basic` as your authority you also need to disable WIA using `GCM_ALLOW_WINDOWSAUTH` / `credential.allowWindowsAuth`.
10
+
11
+
The following table shows the correct replacement for all legacy authorities values:
0 commit comments