Skip to content

Commit

Permalink
Update NOTES.md
Browse files Browse the repository at this point in the history
Fix typos and clean up wording a bit
  • Loading branch information
markphip authored Feb 22, 2024
1 parent 9a72ae5 commit 5d07cbe
Showing 1 changed file with 11 additions and 2 deletions.
13 changes: 11 additions & 2 deletions src/external-repository/NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,12 @@ It is always possible to provide a token via the `userSecret` and this is what w
other Git hosting providers.

#### Microsoft Entra ID Tenant Configuration
The authentication happens on the common tenant. If the user is present on multiple tenant and the Azure DevOps organization for the reposiotory belongs to a specific one the repo opearations may fail (unauthorized). You can configure the tenant for the authenthication by providing it as setting customization to the the underlying extension, following an example:

The authentication to Azure DevOps happens on the default tenant. If the user is present on
multiple tenants, and the Azure DevOps organization for the reposiotory belongs to a specific
one, the repository operations may fail (unauthorized). You can configure the tenant for
the authentication by providing it as setting to the the underlying extension in your devcontainer.json:

```json
"customizations": {
"vscode":{
Expand Down Expand Up @@ -67,7 +72,11 @@ Codespace, then the value of that secret will be used as a PAT for authenticatio
is not defined by the user it will fallback to the browser login.

### Interactive authentication only (avoids PAT token)
The advantage of using a PAT token is the ability to clone the repository during the devContainer creation (onCreateCommand). You can avoid to configure any secret by requiring the authentication once the Codespace load it means that the repository will be cloned when the Codespaces UI initielizes completely. Following a configuration example for this scenario:

The advantage of using a PAT token is the ability to clone the repository during the devContainer creation
(onCreateCommand). You can avoid the need to configure a secret by requiring the authentication once the
Codespace loads. This means the repository will be cloned only after the Codespaces UI initializes completely:

```json
{
"image": "mcr.microsoft.com/devcontainers/universal:ubuntu",
Expand Down

0 comments on commit 5d07cbe

Please sign in to comment.