diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 989348cab..ddaf0b82b 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -12,6 +12,22 @@ "source_path": "msal-dotnet-articles/advanced/subject-name-and-issuer-authentication.md", "redirect_url": "/entra/msal/dotnet/" }, + { + "source_path": "msal-dotnet-articles/contribute/bugs-and-feature-requests.md", + "redirect_url": "https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/CONTRIBUTING.md" + }, + { + "source_path": "msal-dotnet-articles/contribute/build-and-test.md", + "redirect_url": "https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/CONTRIBUTING.md" + }, + { + "source_path": "msal-dotnet-articles/contribute/overview.md", + "redirect_url": "https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/CONTRIBUTING.md" + }, + { + "source_path": "msal-dotnet-articles/contribute/prerequisites-to-build.md", + "redirect_url": "https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/main/CONTRIBUTING.md" + }, { "source_path": "msal-dotnet-articles/acquiring-tokens/msal-net-client-assertions.md", "redirect_url": "/entra/msal/dotnet/acquiring-tokens/web-apps-apis/confidential-client-assertions" diff --git a/dotnet/xml/FrameworksIndex/msal-model-dotnet-latest.xml b/dotnet/xml/FrameworksIndex/msal-model-dotnet-latest.xml index bd88a7467..725506086 100644 --- a/dotnet/xml/FrameworksIndex/msal-model-dotnet-latest.xml +++ b/dotnet/xml/FrameworksIndex/msal-model-dotnet-latest.xml @@ -1,7 +1,7 @@  - + @@ -160,7 +160,7 @@ - + diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/AcquireTokenOptions.xml b/dotnet/xml/Microsoft.Identity.Abstractions/AcquireTokenOptions.xml index 3208c0fcd..b97bafeb9 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/AcquireTokenOptions.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/AcquireTokenOptions.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Object @@ -39,6 +40,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -63,6 +65,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -89,6 +92,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -118,6 +122,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -147,6 +152,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.AcquireTokenOptions @@ -175,6 +181,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Nullable<System.Guid> @@ -202,6 +209,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IDictionary<System.String,System.String> @@ -227,6 +235,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IDictionary<System.String,System.String> @@ -255,6 +264,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Boolean @@ -286,6 +296,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -318,6 +329,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -345,6 +357,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -372,6 +385,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -402,6 +416,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -432,6 +447,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/AcquireTokenResult.xml b/dotnet/xml/Microsoft.Identity.Abstractions/AcquireTokenResult.xml index e8a729408..330137048 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/AcquireTokenResult.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/AcquireTokenResult.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Object @@ -39,6 +40,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -78,6 +80,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -107,6 +110,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Guid @@ -135,6 +139,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.DateTimeOffset @@ -164,6 +169,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -191,6 +197,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IEnumerable<System.String> @@ -219,6 +226,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -249,6 +257,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/AuthorizationHeaderProviderOptions.xml b/dotnet/xml/Microsoft.Identity.Abstractions/AuthorizationHeaderProviderOptions.xml index b1fd9a7fc..a73fbd48c 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/AuthorizationHeaderProviderOptions.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/AuthorizationHeaderProviderOptions.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Object @@ -39,6 +40,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -63,6 +65,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -90,6 +93,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.AcquireTokenOptions @@ -117,6 +121,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -144,6 +149,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.AuthorizationHeaderProviderOptions @@ -172,6 +178,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.AuthorizationHeaderProviderOptions @@ -200,6 +207,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Action<System.Net.Http.HttpRequestMessage> @@ -229,6 +237,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -243,11 +252,11 @@ - - + + - - + + Property Microsoft.Identity.Abstractions @@ -257,6 +266,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -265,7 +275,7 @@ - System.Net.Http.HttpMethod + System.String @@ -290,6 +300,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -323,6 +334,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -350,6 +362,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Boolean diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/CredentialDescription.xml b/dotnet/xml/Microsoft.Identity.Abstractions/CredentialDescription.xml index c8b4e8182..d64382248 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/CredentialDescription.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/CredentialDescription.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Object @@ -43,6 +44,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -65,6 +67,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -101,6 +104,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Object @@ -129,6 +133,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Security.Cryptography.X509Certificates.X509Certificate2 @@ -159,6 +164,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -199,6 +205,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -210,8 +217,8 @@ To be added. To be added. + - CurrentUser/My) and specified by its distinguised name, used as a client credential in a confidential client application: @@ -221,7 +228,7 @@ :::code language="csharp" source="~/../abstractions-samples/test/Microsoft.Identity.Abstractions.Tests/CredentialDescriptionTest.cs" id="distinguishedname_csharp"::: ]]> - + @@ -239,6 +246,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -278,6 +286,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -291,10 +300,10 @@ To be added. Use this property in conjunction with or . - - + + @@ -312,6 +321,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -323,8 +333,8 @@ To be added. Use this property in conjunction with . + - CurrentUser/My) and specified by its thumbprint, used as a client credential in a confidential client application: @@ -334,7 +344,7 @@ :::code language="csharp" source="~/../abstractions-samples/test/Microsoft.Identity.Abstractions.Tests/CredentialDescriptionTest.cs" id="thumbprint_csharp"::: ]]> - + @@ -352,6 +362,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -389,6 +400,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -429,6 +441,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialType @@ -461,6 +474,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.AuthorizationHeaderProviderOptions @@ -496,6 +510,7 @@ Microsoft.Identity.Abstractions 4.1.0.0 + 5.0.0.0 System.String @@ -523,6 +538,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -560,6 +576,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -599,6 +616,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -638,6 +656,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -691,6 +710,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -733,6 +753,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Boolean @@ -762,6 +783,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/CredentialSource.xml b/dotnet/xml/Microsoft.Identity.Abstractions/CredentialSource.xml index 5de47db10..866edc48b 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/CredentialSource.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/CredentialSource.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Enum @@ -43,6 +44,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -81,6 +83,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -117,6 +120,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -144,6 +148,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -180,6 +185,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -217,6 +223,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -252,6 +259,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -289,6 +297,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -326,6 +335,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -354,6 +364,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -391,6 +402,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/CredentialSourceLoaderParameters.xml b/dotnet/xml/Microsoft.Identity.Abstractions/CredentialSourceLoaderParameters.xml index 63acedae0..c179519d5 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/CredentialSourceLoaderParameters.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/CredentialSourceLoaderParameters.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Object @@ -42,6 +43,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -72,6 +74,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -99,6 +102,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/CredentialType.xml b/dotnet/xml/Microsoft.Identity.Abstractions/CredentialType.xml index 3dfbff199..6393391b4 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/CredentialType.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/CredentialType.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Enum @@ -40,6 +41,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialType @@ -67,6 +69,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialType @@ -93,6 +96,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialType @@ -119,6 +123,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialType diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/DownstreamApiOptions.xml b/dotnet/xml/Microsoft.Identity.Abstractions/DownstreamApiOptions.xml index 700ed9f21..02d7e3ffe 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/DownstreamApiOptions.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/DownstreamApiOptions.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.AuthorizationHeaderProviderOptions @@ -69,6 +70,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -93,6 +95,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -120,6 +123,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.DownstreamApiOptions @@ -148,6 +152,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.AuthorizationHeaderProviderOptions @@ -175,6 +180,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Func<System.Net.Http.HttpContent,System.Object> @@ -203,6 +209,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IEnumerable<System.String> @@ -234,6 +241,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Func<System.Object,System.Net.Http.HttpContent> diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/DownstreamApiOptionsReadOnlyHttpMethod.xml b/dotnet/xml/Microsoft.Identity.Abstractions/DownstreamApiOptionsReadOnlyHttpMethod.xml index b007ac8b0..b51cf7d6c 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/DownstreamApiOptionsReadOnlyHttpMethod.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/DownstreamApiOptionsReadOnlyHttpMethod.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.DownstreamApiOptions @@ -24,28 +25,23 @@ This class is useful to provide a better developer experience on the specialized methods of where the HTTP method is provided already by the name of the - method, and should not be overriden by the options. You shouldn't need to use it directly. + method, and should not be overridden by the options. You shouldn't need to use it directly. - - - - - + + + + + Constructor Microsoft.Identity.Abstractions - 2.1.0.0 - 3.1.0.0 - 3.2.0.0 - 3.2.1.0 - 4.0.0.0 - 4.1.0.0 + 5.0.0.0 - + Options @@ -71,6 +67,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.DownstreamApiOptionsReadOnlyHttpMethod @@ -99,6 +96,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.AuthorizationHeaderProviderOptions @@ -112,11 +110,11 @@ - - + + - - + + Property Microsoft.Identity.Abstractions @@ -126,9 +124,10 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 - System.Net.Http.HttpMethod + System.String diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/IAuthorizationHeaderProvider.xml b/dotnet/xml/Microsoft.Identity.Abstractions/IAuthorizationHeaderProvider.xml index 5439249ed..d2cf85938 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/IAuthorizationHeaderProvider.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/IAuthorizationHeaderProvider.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -36,6 +37,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<System.String> @@ -76,6 +78,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<System.String> diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/ICredentialSourceLoader.xml b/dotnet/xml/Microsoft.Identity.Abstractions/ICredentialSourceLoader.xml index 3d193fb24..6a9759794 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/ICredentialSourceLoader.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/ICredentialSourceLoader.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -36,6 +37,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.CredentialSource @@ -63,6 +65,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/ICredentialsLoader.xml b/dotnet/xml/Microsoft.Identity.Abstractions/ICredentialsLoader.xml index c87d43da8..1dd86becd 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/ICredentialsLoader.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/ICredentialsLoader.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -41,6 +42,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IDictionary<Microsoft.Identity.Abstractions.CredentialSource,Microsoft.Identity.Abstractions.ICredentialSourceLoader> @@ -69,6 +71,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -103,6 +106,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<Microsoft.Identity.Abstractions.CredentialDescription> @@ -140,6 +144,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Void diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/IDownstreamApi.xml b/dotnet/xml/Microsoft.Identity.Abstractions/IDownstreamApi.xml index dc3adaadb..ac8708783 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/IDownstreamApi.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/IDownstreamApi.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -36,6 +37,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> @@ -79,6 +81,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> @@ -129,6 +132,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> @@ -172,6 +176,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -219,6 +224,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -270,6 +276,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> @@ -319,6 +326,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -370,6 +378,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -454,6 +463,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -512,6 +522,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -576,6 +587,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -638,6 +650,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -706,6 +719,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -765,6 +779,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -829,6 +844,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -892,6 +908,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -960,6 +977,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -1018,6 +1036,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -1082,6 +1101,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -1144,6 +1164,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -1212,6 +1233,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -1270,6 +1292,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -1334,6 +1357,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -1396,6 +1420,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -1464,6 +1489,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -1522,6 +1548,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> @@ -1586,6 +1613,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task @@ -1648,6 +1676,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<TOutput> diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/ITokenAcquirer.xml b/dotnet/xml/Microsoft.Identity.Abstractions/ITokenAcquirer.xml index 2839c26a6..dce9e63b9 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/ITokenAcquirer.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/ITokenAcquirer.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -36,6 +37,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<Microsoft.Identity.Abstractions.AcquireTokenResult> @@ -76,6 +78,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Threading.Tasks.Task<Microsoft.Identity.Abstractions.AcquireTokenResult> diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/ITokenAcquirerFactory.xml b/dotnet/xml/Microsoft.Identity.Abstractions/ITokenAcquirerFactory.xml index 47b184af4..f6adeb668 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/ITokenAcquirerFactory.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/ITokenAcquirerFactory.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -36,6 +37,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.ITokenAcquirer @@ -69,6 +71,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.ITokenAcquirer diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/IdentityApplicationOptions.xml b/dotnet/xml/Microsoft.Identity.Abstractions/IdentityApplicationOptions.xml index 518fba42c..5368eece9 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/IdentityApplicationOptions.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/IdentityApplicationOptions.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Object @@ -43,6 +44,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -65,6 +67,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Boolean @@ -98,6 +101,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -126,6 +130,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IEnumerable<System.String> @@ -173,6 +178,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -211,6 +217,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IEnumerable<Microsoft.Identity.Abstractions.CredentialDescription> @@ -264,6 +271,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -292,6 +300,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Boolean @@ -321,6 +330,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IDictionary<System.String,System.String> @@ -349,6 +359,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IEnumerable<Microsoft.Identity.Abstractions.CredentialDescription> diff --git a/dotnet/xml/Microsoft.Identity.Abstractions/MicrosoftIdentityApplicationOptions.xml b/dotnet/xml/Microsoft.Identity.Abstractions/MicrosoftIdentityApplicationOptions.xml index afdfce1e2..bac9ecd0f 100644 --- a/dotnet/xml/Microsoft.Identity.Abstractions/MicrosoftIdentityApplicationOptions.xml +++ b/dotnet/xml/Microsoft.Identity.Abstractions/MicrosoftIdentityApplicationOptions.xml @@ -12,6 +12,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 Microsoft.Identity.Abstractions.IdentityApplicationOptions @@ -39,6 +40,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 @@ -61,6 +63,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -90,6 +93,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -119,6 +123,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Collections.Generic.IEnumerable<System.String> @@ -148,6 +153,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -175,6 +181,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -202,6 +209,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -229,6 +237,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -258,6 +267,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -285,6 +295,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -315,6 +326,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -342,6 +354,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Boolean @@ -376,6 +389,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -403,6 +417,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.String @@ -433,6 +448,7 @@ 3.2.1.0 4.0.0.0 4.1.0.0 + 5.0.0.0 System.Boolean diff --git a/dotnet/xml/PackageInformation/msal-model-dotnet-latest.json b/dotnet/xml/PackageInformation/msal-model-dotnet-latest.json index 51330bdf5..bbc56af4e 100644 --- a/dotnet/xml/PackageInformation/msal-model-dotnet-latest.json +++ b/dotnet/xml/PackageInformation/msal-model-dotnet-latest.json @@ -1 +1 @@ -{"msal-model-dotnet-latest":{"Microsoft.Identity.Abstractions":{"Name":"Microsoft.Identity.Abstractions","Version":"4.1.0","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web":{"Name":"Microsoft.Identity.Web","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.Certificate":{"Name":"Microsoft.Identity.Web.Certificate","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.Certificateless":{"Name":"Microsoft.Identity.Web.Certificateless","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.DownstreamRestApi":{"Name":"Microsoft.Identity.Web.DownstreamRestApi","Version":"2.0.8-preview","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.TokenCache":{"Name":"Microsoft.Identity.Web.TokenCache","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.MicrosoftGraph":{"Name":"Microsoft.Identity.Web.MicrosoftGraph","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.MicrosoftGraphBeta":{"Name":"Microsoft.Identity.Web.MicrosoftGraphBeta","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.OWIN":{"Name":"Microsoft.Identity.Web.OWIN","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.TokenAcquisition":{"Name":"Microsoft.Identity.Web.TokenAcquisition","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.UI":{"Name":"Microsoft.Identity.Web.UI","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.UI.Views":{"Name":"Microsoft.Identity.Web.UI","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.Azure":{"Name":"Microsoft.Identity.Web.Azure","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"}}} \ No newline at end of file +{"msal-model-dotnet-latest":{"Microsoft.Identity.Abstractions":{"Name":"Microsoft.Identity.Abstractions","Version":"5.0.0","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web":{"Name":"Microsoft.Identity.Web","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.Certificate":{"Name":"Microsoft.Identity.Web.Certificate","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.Certificateless":{"Name":"Microsoft.Identity.Web.Certificateless","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.DownstreamRestApi":{"Name":"Microsoft.Identity.Web.DownstreamRestApi","Version":"2.0.8-preview","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.TokenCache":{"Name":"Microsoft.Identity.Web.TokenCache","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.MicrosoftGraph":{"Name":"Microsoft.Identity.Web.MicrosoftGraph","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.MicrosoftGraphBeta":{"Name":"Microsoft.Identity.Web.MicrosoftGraphBeta","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.OWIN":{"Name":"Microsoft.Identity.Web.OWIN","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.TokenAcquisition":{"Name":"Microsoft.Identity.Web.TokenAcquisition","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.UI":{"Name":"Microsoft.Identity.Web.UI","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.UI.Views":{"Name":"Microsoft.Identity.Web.UI","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"},"Microsoft.Identity.Web.Azure":{"Name":"Microsoft.Identity.Web.Azure","Version":"2.13.4","Feed":"https://api.nuget.org/v3/index.json"}}} \ No newline at end of file diff --git a/msal-dotnet-articles/TOC.yml b/msal-dotnet-articles/TOC.yml index 8956ab076..9e2949ff9 100644 --- a/msal-dotnet-articles/TOC.yml +++ b/msal-dotnet-articles/TOC.yml @@ -173,17 +173,6 @@ href: how-to/create-config-for-mam-conditional-access.md - name: Getting tenant profiles href: how-to/get-tenant-profiles.md - - - name: Contribute - items: - - name: Overview - href: contribute/overview.md - - name: Prerequisites to build MSAL.NET - href: contribute/prerequisites-to-build.md - - name: Build and test MSAL.NET - href: contribute/build-and-test.md - - name: Submitting bugs and feature requests - href: contribute/bugs-and-feature-requests.md - name: Additional resources items: - name: Semantic versioning and API change management diff --git a/msal-dotnet-articles/contribute/bugs-and-feature-requests.md b/msal-dotnet-articles/contribute/bugs-and-feature-requests.md deleted file mode 100644 index fd09ce37f..000000000 --- a/msal-dotnet-articles/contribute/bugs-and-feature-requests.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Submitting bugs and feature requests -description: "How to contribute by filing bugs and feature requests for Microsoft Authentication Library for .NET." ---- - -# Submitting bugs and feature requests - -## Before submitting an issue - -First, please do a search of [open issues](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues) to see if the issue or feature request has already been filed. Use the tags to narrow down your search. Here's an example of a [query for Xamarin iOS specific issues](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues?utf8=%E2%9C%93&q=is:issue+is:open+label:scenario:Mobile-iOS). - -If you find your issue already exists, add a relevant comment. You can also use an upvote or downvote reaction in place of a "+1" comment. - -If your issue is a question, and is not addressed in the documentation, please ask the question on [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-ad-msal) using the tag `azure-ad-msal`. - -If you cannot find an existing issue that describes your bug or feature request, submit an issue using the guidelines below. - -## Write detailed bug reports and feature requests - -File a single issue per bug and feature request: - -- Do not enumerate multiple bugs or feature requests in the same issue. -- Do not add your issue as a comment to an existing issue unless it's for the identical input. Many issues look similar, but have different causes. - -When [submitting an issue](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues/new/choose), select the correct category, **Bug Report**, **Documentation**, or **Feature request**. - -### Bug report - -The more information you provide, the more likely someone will be successful in reproducing the issue and finding a fix. -Please use the [Bug Report template](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues/new?template=bug_report.md) and complete as much of the information listed as possible. Please use the [latest version of the library](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/releases) and see if your bug still exists before filing an issue. - -Remember to do the following: - -- Search the issue repository to see if there exists a duplicate issue. -- Update to the latest version of the library to see if the issue still exists. -- Submit an issue by filling out all as much of the information in the Bug Report as possible. - -### Documentation Requests - -If you find our documentation or XML comments lacking in necessary detail, submit a [Documentation request](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues/new?template=documentation.md). - -If you have found errors in the documentation, or if an example or code snippet is needed, [open an issue in the documentation repository](https://github.com/MicrosoftDocs/microsoft-authentication-library-dotnet/issues). - -### Feature requests - -Have a feature request for MSAL? Complete a [Feature Request](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues/new?template=feature_request.md) or consider making a [contribution](../contribute/overview.md) to the library. Make sure your feature request is clear and concise and contains a detailed description of the problem. Please include any alternative solutions or features you may have considered. - -## Contributing fixes - -If you are interested in fixing issues and contributing directly to the code base, please see the [Contributing overview](../contribute/overview.md). diff --git a/msal-dotnet-articles/contribute/build-and-test.md b/msal-dotnet-articles/contribute/build-and-test.md deleted file mode 100644 index f0e1701fa..000000000 --- a/msal-dotnet-articles/contribute/build-and-test.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: Building and testing MSAL.NET -description: "How to build and test MSAL.NET on your local machine." ---- - -# Building and testing MSAL.NET - -## Prerequisites to build MSAL.NET - -Prerequisites to build MSAL.NET can be found in [Prerequisites to build MSAL.NET](prerequisites-to-build.md). - -## Fast build - -MSAL.NET supports several target frameworks, but most of the time contributors are only interested in one or two. To get MSAL to build for all frameworks, contributors will need a [hefty Visual Studio installation as well as several SDKs](prerequisites-to-build.md). - -To work around this requirement, open [`Microsoft.Identity.Client.csproj`](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/blob/master/src/client/Microsoft.Identity.Client/Microsoft.Identity.Client.csproj) and comment out the targets you are not interested in. Keeping the pure .NET targets and eliminating UWP and Xamarin results in a fast build as well as the ability to run all unit tests. - -Visual Studio may need to be restarted to ensure that updated target frameworks take effect. - -### Visual Studio for Mac - -MSAL is a multi-target library and at the time of writing, Visual Studio for Mac is not able to understand and layout this project correctly. The library can still be built from the command line on macOS. - -### Visual Studio - -1. Load `LibsAndSamples.sln` for a bigger solution with lots of apps that showcase and exercise MSAL. Load `LibsNoSamples.sln` for a small solution that has the library and the tests. -2. Build in Visual Studio (if configured) or via the command line with `msbuild /t:restore` and `msbuild`. If using the command line, developers might need to use the [Visual Studio Developer Command Prompt](/visualstudio/ide/reference/command-prompt-powershell). - ->[!NOTE] ->If you run into strong name validation issues, please [log a bug](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet/issues). Workaround is to disable strong name validation on your dev box by running the following command in the Visual Studio Developer Command Prompt with Administrator permissions: -> ->```bash ->sn -Vr * ->``` - ->[!WARNING] ->You won't be able to run the integration or automation tests because they require access to a Microsoft Key Vault instance which is only accessible to the MSAL.NET engineering team. These tests will run as part of our automation pipelines in GitHub. - -#### Package - -You can create a package from Visual Studio or from the command line with custom version parameters: - -```bash -msbuild .csproj /t:pack /p:MsalClientSemVer=1.2.3-preview -``` - -### Command Line - -You can use `msbuild` commands to build the solution. Use `msbuild /t:restore` and `msbuild`. - ->[!NOTE] ->Do not use the `dotnet` command line because it is only for .NET and .NET Core - this library has many other targets that are not possible to build with the .NET tooling. - ->[!NOTE] ->To enable the library to target Xamarin as well as .NET and .NET Core, there is a dependency on [MsBuild SDK Extras](https://github.com/novotnyllc/MSBuildSdkExtras). See the ["Support for command line dotnet build or dotnet msbuild"](https://github.com/novotnyllc/MSBuildSdkExtras/issues/102) issue in regards to using `dotnet` CLI commands. diff --git a/msal-dotnet-articles/contribute/overview.md b/msal-dotnet-articles/contribute/overview.md deleted file mode 100644 index 2c5b01dc5..000000000 --- a/msal-dotnet-articles/contribute/overview.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Contributing to MSAL.NET ---- - -# Contributing to MSAL.NET - -Microsoft Authentication Library (MSAL) for .NET welcomes new contributors. This document will guide you through the process. - -## Contributor License agreement - -Please visit [https://cla.microsoft.com/](https://cla.microsoft.com/) and sign the Contributor License Agreement. You only need to do that once. We can not look at your code until you've submitted this request. - -## Building and testing the library - -Please see the [Build and test](build-and-test.md) page. - -## Tests - -It's all standard stuff, but please note that you won't be able to run integration tests locally because they connect to a KeyVault to fetch some test users and passwords. The CI will run them for you. - -## How the MSAL team deals with forks - -The CI build will not run on a PR opened from a fork, as a security measure. The MSAL team will manually move your branch from your fork to the main repository, to be able to run the CI. This will preserve the identity of the commit. - -```bash -# list existing remotes -git remote -v - -# add a remote to the fork of the contributor -git remote add joe joes_repo_url - -# sync -git fetch joe - -# checkout the contributor's branch -git checkout joes_feature_branch - -# push it to the original repository (AzureAD/MSAL) -git push origin -``` diff --git a/msal-dotnet-articles/contribute/prerequisites-to-build.md b/msal-dotnet-articles/contribute/prerequisites-to-build.md deleted file mode 100644 index b3b794661..000000000 --- a/msal-dotnet-articles/contribute/prerequisites-to-build.md +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Prerequisites to build MSAL.NET -description: "Requirements to build MSAL.NET on your local computer." ---- - -# Prerequisites to build MSAL.NET - -The following are instructions to setup Visual Studio to build various MSAL.NET solution files on Windows and Mac platforms. - -## Windows - -### Minimal Visual Studio installation - -* Install or update Visual Studio 2022. Any edition, such as Community, Pro, or Enterprise will work. -* Install the following workloads: - * .NET desktop development - * Universal Windows Platform development - * Mobile Development with .NET - * .NET Core cross-platform development -* From the **Individual Components** tab, make sure these items are selected: - * .NET Framework 4.5.2 targeting pack - * .NET Framework 4.6.1 SDK - * .NET Framework 4.6.1 targeting pack - * .NET Framework 4.6.2 targeting pack - * Android SDK setup (API level 29) - * Windows 10 SDK 10.0.17134.0 - * Windows 10 SDK 10.0.17763.0 -* Android 9.0 Pie and Android 8.1 Oreo are required. These are not installed through the Visual Studio Installer. Instead, use the Android SDK Manager (**Visual Studio** > **Tools** > **Android** > **Android SDK Manager…**) - -With the setup above, you should be able to open and compile `Libs.sln` and `LibsAndSamples.sln` from the [MSAL.NET repository](https://github.com/AzureAD/microsoft-authentication-library-for-dotnet). - -### Troubleshooting - -* If you get an exception similar to `"System.InvalidOperationException: Could not determine Android SDK location"` while restoring NuGet packages, make sure you have the latest Android SDK installed. If you do, you probably hit a bug with the Visual Studio Installer - uninstall and reinstall the SDK from the Visual Studio Installer. -* If you get an exception similar to `"System.TypeLoadException: Could not set up parent class, due to: Could not load type of field 'Microsoft.Identity.Core.UI.WebviewBase:asWebAuthenticationSession' (5) due to: Could not resolve type with token 0100004c from typeref (expected class AuthenticationServices.ASWebAuthenticationSession in assembly 'Xamarin.iOS)"` when running on an iOS simulator, **make sure that you have installed the latest Visual Studio 2022 release and the latest version of [Xcode](https://developer.apple.com/xcode/) on your Mac** to get the classes needed to run `ASWebAuthenticationSession` (e.g., `AuthenticationServices`). - -## macOS - -### [Install Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/) - -* During setup, install - * .NET Core - * Android - * iOS - * MacOS -* In Visual Studio for Mac, select **Tools** > **SDK Manager** and install Android SDK with API 29. - -The steps above should enable you to compile `Libs.sln`. You will need a developer certificate to compile `LibsMacOS.sln`.