From 790db2d3cb431b44b40e5e4f59803c34dd7c9dd8 Mon Sep 17 00:00:00 2001 From: fuixx217 Date: Tue, 10 Dec 2024 10:02:50 -0500 Subject: [PATCH 1/6] Update cli-ref-sources.md Adding some clarifying items when interacting with a custom/private Azure DevOps NuGet feed. --- docs/reference/cli-reference/cli-ref-sources.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/reference/cli-reference/cli-ref-sources.md b/docs/reference/cli-reference/cli-ref-sources.md index 827cdb3c4..19bd4d18e 100644 --- a/docs/reference/cli-reference/cli-ref-sources.md +++ b/docs/reference/cli-reference/cli-ref-sources.md @@ -55,6 +55,10 @@ where `` is one of *List, Add, Remove, Enable, Disable,* or *Update*, - **`-Password`** Specifies the password for authenticating with the source. + + > [!NOTE] + > When using an Azure DevOps Artifacts NuGet feed, this value should be set to a Personal Access Token (PAT) that is set with Read&Write under Packaging. + > To access the Personal Access Token section of Azure DevOps, go to https://dev.azure.com/yourprojectname/_usersSettings/tokens where yourprojectname is the name of your project. You can get there also by clicking the User Settings icon next to your logo in Azure DevOps, and selecting Personal Access Tokens. > [!NOTE] > Be aware that encrypted passwords are only supported on Windows. @@ -76,6 +80,9 @@ where `` is one of *List, Add, Remove, Enable, Disable,* or *Update*, Specifies the user name for authenticating with the source. + > [!NOTE] + > When using an Azure DevOps Artifacts NuGet feed, this value is ignored in favor of the Personal Access Toek provided in the Password parameter. + - **`-ValidAuthenticationTypes`** Comma-separated list of valid authentication types for this source. By default, all authentication types are valid. Example: `basic,negotiate`. @@ -107,5 +114,7 @@ nuget sources Enable -Name "nuget.org" nuget sources add -name foo.bar -source C:\NuGet\local -username foo -password bar -StorePasswordInClearText -configfile %AppData%\NuGet\my.config +nuget sources add -name MyAzureDevOpsSource -source "https://pkgs.dev.azure.com/yourorgname/yourprojectname/_packaging/yourfeedname/nuget/v3/index.json" -username foo -password + nuget sources Update -Name "nuget.org" -ProtocolVersion 3 ``` From c89ef40f95db7bc856e525a9e4bc3fd35d26626d Mon Sep 17 00:00:00 2001 From: fuixx217 Date: Wed, 11 Dec 2024 13:17:45 -0500 Subject: [PATCH 2/6] Update cli-ref-sources.md --- docs/reference/cli-reference/cli-ref-sources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/cli-reference/cli-ref-sources.md b/docs/reference/cli-reference/cli-ref-sources.md index 19bd4d18e..ecc8d7ee8 100644 --- a/docs/reference/cli-reference/cli-ref-sources.md +++ b/docs/reference/cli-reference/cli-ref-sources.md @@ -58,7 +58,7 @@ where `` is one of *List, Add, Remove, Enable, Disable,* or *Update*, > [!NOTE] > When using an Azure DevOps Artifacts NuGet feed, this value should be set to a Personal Access Token (PAT) that is set with Read&Write under Packaging. - > To access the Personal Access Token section of Azure DevOps, go to https://dev.azure.com/yourprojectname/_usersSettings/tokens where yourprojectname is the name of your project. You can get there also by clicking the User Settings icon next to your logo in Azure DevOps, and selecting Personal Access Tokens. + > For information about provisioning Azure DevOps Personal Access Tokens, please review [Azure DevOps - Use personal access tokens](https://learn.microsoft.com/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows) > [!NOTE] > Be aware that encrypted passwords are only supported on Windows. From a24b43495276141099aa1f3938bd583842564d64 Mon Sep 17 00:00:00 2001 From: fuixx217 Date: Wed, 11 Dec 2024 14:30:23 -0500 Subject: [PATCH 3/6] Update cli-ref-sources.md --- docs/reference/cli-reference/cli-ref-sources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/cli-reference/cli-ref-sources.md b/docs/reference/cli-reference/cli-ref-sources.md index ecc8d7ee8..b0a57728f 100644 --- a/docs/reference/cli-reference/cli-ref-sources.md +++ b/docs/reference/cli-reference/cli-ref-sources.md @@ -58,7 +58,7 @@ where `` is one of *List, Add, Remove, Enable, Disable,* or *Update*, > [!NOTE] > When using an Azure DevOps Artifacts NuGet feed, this value should be set to a Personal Access Token (PAT) that is set with Read&Write under Packaging. - > For information about provisioning Azure DevOps Personal Access Tokens, please review [Azure DevOps - Use personal access tokens](https://learn.microsoft.com/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows) + > For information about provisioning Azure DevOps Personal Access Tokens, please review [Azure DevOps - Use personal access tokens](../../organizations/accounts/use-personal-access-tokens-to-authenticate) > [!NOTE] > Be aware that encrypted passwords are only supported on Windows. From 751eac62f9435f45ddd29d99f215a4c28f0f11dd Mon Sep 17 00:00:00 2001 From: fuixx217 Date: Wed, 11 Dec 2024 14:42:16 -0500 Subject: [PATCH 4/6] Update cli-ref-sources.md --- docs/reference/cli-reference/cli-ref-sources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/cli-reference/cli-ref-sources.md b/docs/reference/cli-reference/cli-ref-sources.md index b0a57728f..2faa7b1e6 100644 --- a/docs/reference/cli-reference/cli-ref-sources.md +++ b/docs/reference/cli-reference/cli-ref-sources.md @@ -58,7 +58,7 @@ where `` is one of *List, Add, Remove, Enable, Disable,* or *Update*, > [!NOTE] > When using an Azure DevOps Artifacts NuGet feed, this value should be set to a Personal Access Token (PAT) that is set with Read&Write under Packaging. - > For information about provisioning Azure DevOps Personal Access Tokens, please review [Azure DevOps - Use personal access tokens](../../organizations/accounts/use-personal-access-tokens-to-authenticate) + > For information about provisioning Azure DevOps Personal Access Tokens, please review [Azure DevOps - Use personal access tokens](azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate) > [!NOTE] > Be aware that encrypted passwords are only supported on Windows. From 84fdbff97012dd2c3753e8e2b48f1f372955d007 Mon Sep 17 00:00:00 2001 From: fuixx217 Date: Wed, 11 Dec 2024 14:45:56 -0500 Subject: [PATCH 5/6] Update cli-ref-sources.md --- docs/reference/cli-reference/cli-ref-sources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/cli-reference/cli-ref-sources.md b/docs/reference/cli-reference/cli-ref-sources.md index 2faa7b1e6..0fc24d97e 100644 --- a/docs/reference/cli-reference/cli-ref-sources.md +++ b/docs/reference/cli-reference/cli-ref-sources.md @@ -58,7 +58,7 @@ where `` is one of *List, Add, Remove, Enable, Disable,* or *Update*, > [!NOTE] > When using an Azure DevOps Artifacts NuGet feed, this value should be set to a Personal Access Token (PAT) that is set with Read&Write under Packaging. - > For information about provisioning Azure DevOps Personal Access Tokens, please review [Azure DevOps - Use personal access tokens](azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate) + > For information about provisioning Azure DevOps Personal Access Tokens, please review [Azure DevOps - Use personal access tokens](/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate) > [!NOTE] > Be aware that encrypted passwords are only supported on Windows. From e0e82d5ca81ec5ddca4dfda4d44019c7e359991a Mon Sep 17 00:00:00 2001 From: fuixx217 Date: Thu, 16 Jan 2025 10:58:45 -0500 Subject: [PATCH 6/6] Update cli-ref-sources.md --- docs/reference/cli-reference/cli-ref-sources.md | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/docs/reference/cli-reference/cli-ref-sources.md b/docs/reference/cli-reference/cli-ref-sources.md index 0fc24d97e..56935e51b 100644 --- a/docs/reference/cli-reference/cli-ref-sources.md +++ b/docs/reference/cli-reference/cli-ref-sources.md @@ -55,10 +55,6 @@ where `` is one of *List, Add, Remove, Enable, Disable,* or *Update*, - **`-Password`** Specifies the password for authenticating with the source. - - > [!NOTE] - > When using an Azure DevOps Artifacts NuGet feed, this value should be set to a Personal Access Token (PAT) that is set with Read&Write under Packaging. - > For information about provisioning Azure DevOps Personal Access Tokens, please review [Azure DevOps - Use personal access tokens](/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate) > [!NOTE] > Be aware that encrypted passwords are only supported on Windows. @@ -80,9 +76,6 @@ where `` is one of *List, Add, Remove, Enable, Disable,* or *Update*, Specifies the user name for authenticating with the source. - > [!NOTE] - > When using an Azure DevOps Artifacts NuGet feed, this value is ignored in favor of the Personal Access Toek provided in the Password parameter. - - **`-ValidAuthenticationTypes`** Comma-separated list of valid authentication types for this source. By default, all authentication types are valid. Example: `basic,negotiate`. @@ -114,7 +107,7 @@ nuget sources Enable -Name "nuget.org" nuget sources add -name foo.bar -source C:\NuGet\local -username foo -password bar -StorePasswordInClearText -configfile %AppData%\NuGet\my.config -nuget sources add -name MyAzureDevOpsSource -source "https://pkgs.dev.azure.com/yourorgname/yourprojectname/_packaging/yourfeedname/nuget/v3/index.json" -username foo -password +nuget sources add -name MyAzureDevOpsSource -source "https://pkgs.dev.azure.com/yourorgname/yourprojectname/_packaging/yourfeedname/nuget/v3/index.json" -username ignored -password nuget sources Update -Name "nuget.org" -ProtocolVersion 3 ```