#nullable enable #pragma warning disable CS0618 using System.ComponentModel; using System.Diagnostics.CodeAnalysis; using System.Reflection; using System.Runtime.InteropServices; using System.Runtime.Versioning; using System.Security.Claims; using System.Security.Cryptography; using System.Security.Cryptography.X509Certificates; using Microsoft.Extensions.DependencyInjection.Extensions; using Microsoft.Extensions.Options; using Microsoft.IdentityModel.Tokens; using OpenIddict.Client; using OpenIddict.Client.WebIntegration; using OpenIddict.Extensions; using static OpenIddict.Client.WebIntegration.OpenIddictClientWebIntegrationConstants; namespace Microsoft.Extensions.DependencyInjection; public sealed partial class OpenIddictClientWebIntegrationBuilder { {% for provider in providers %} {% if provider.documentation -%} /// /// Adds a new {{ provider.display_name }} client registration. /// For more information, read the documentation. /// {% else %} /// /// Adds a new {{ provider.display_name }} client registration. /// {% endif -%} /// The delegate used to configure the OpenIddict/{{ provider.display_name }} options. /// The instance. {% if provider.obsolete -%} [Obsolete("This provider is no longer supported and will be removed in a future version.")] {% endif -%} public OpenIddictClientWebIntegrationBuilder Add{{ provider.name }}(Action configuration) { ArgumentNullException.ThrowIfNull(configuration); var registration = new OpenIddictClientRegistration { ProviderSettings = new OpenIddictClientWebIntegrationSettings.{{ provider.name }}(), ProviderType = ProviderTypes.{{ provider.name }} }; configuration(new OpenIddictClientWebIntegrationBuilder.{{ provider.name }}(registration)); Services.Configure(options => options.Registrations.Add(registration)); return this; } {% endfor %} {% for provider in providers %} /// /// Exposes the necessary methods required to configure the {{ provider.display_name }} integration. /// {% if provider.obsolete -%} [Obsolete("This provider is no longer supported and will be removed in a future version.")] {% endif -%} public sealed partial class {{ provider.name }} { /// /// Initializes a new instance of . /// /// The client registration. public {{ provider.name }}(OpenIddictClientRegistration registration) => Registration = registration ?? throw new ArgumentNullException(nameof(registration)); /// /// Gets the client registration. /// [EditorBrowsable(EditorBrowsableState.Never)] public OpenIddictClientRegistration Registration { get; } /// /// Adds one or more client authentication methods to the list of client authentication methods that can be negotiated for this provider. /// /// The client authentication methods. /// Note: explicitly configuring the allowed client authentication methods is NOT recommended in most cases. /// The instance. [EditorBrowsable(EditorBrowsableState.Advanced)] public {{ provider.name }} AddClientAuthenticationMethods(params string[] methods) { ArgumentNullException.ThrowIfNull(methods); Registration.ClientAuthenticationMethods.UnionWith(methods); return this; } /// /// Adds one or more code challenge methods to the list of code challenge methods that can be negotiated for this provider. /// /// The code challenge methods. /// Note: explicitly configuring the allowed code challenge methods is NOT recommended in most cases. /// The instance. [EditorBrowsable(EditorBrowsableState.Advanced)] public {{ provider.name }} AddCodeChallengeMethods(params string[] methods) { ArgumentNullException.ThrowIfNull(methods); Registration.CodeChallengeMethods.UnionWith(methods); return this; } /// /// Adds one or more grant types to the list of grant types that can be negotiated for this provider. /// /// The grant types. /// Note: explicitly configuring the allowed grant types is NOT recommended in most cases. /// The instance. [EditorBrowsable(EditorBrowsableState.Advanced)] public {{ provider.name }} AddGrantTypes(params string[] types) { ArgumentNullException.ThrowIfNull(types); Registration.GrantTypes.UnionWith(types); return this; } /// /// Adds one or more response modes to the list of response modes that can be negotiated for this provider. /// /// The response modes. /// Note: explicitly configuring the allowed response modes is NOT recommended in most cases. /// The instance. [EditorBrowsable(EditorBrowsableState.Advanced)] public {{ provider.name }} AddResponseModes(params string[] modes) { ArgumentNullException.ThrowIfNull(modes); Registration.ResponseModes.UnionWith(modes); return this; } /// /// Adds one or more response types to the list of response types that can be negotiated for this provider. /// /// The response types. /// Note: explicitly configuring the allowed response types is NOT recommended in most cases. /// The instance. [EditorBrowsable(EditorBrowsableState.Advanced)] public {{ provider.name }} AddResponseTypes(params string[] types) { ArgumentNullException.ThrowIfNull(types); Registration.ResponseTypes.UnionWith(types); return this; } /// /// Adds one or more scopes to the list of requested scopes, if applicable. /// /// The scopes. /// The instance. public {{ provider.name }} AddScopes(params string[] scopes) { ArgumentNullException.ThrowIfNull(scopes); Registration.Scopes.UnionWith(scopes); return this; } /// /// Disables pushed authorization requests for this client registration. When pushed authorization /// requests are disabled, PAR is not used by the OpenIddict client, even if the remote authorization /// server exposes a pushed authorization endpoint. If the authorization server requires using PAR, /// an exception is automatically thrown when starting an interactive authentication challenge. /// /// The instance. public {{ provider.name }} DisablePushedAuthorizationRequests() { Registration.DisablePushedAuthorizationRequests = true; return this; } /// /// Sets the issuer that will be attached to the /// instances created by the OpenIddict client stack for this provider. /// /// The claims issuer. /// The instance. public {{ provider.name }} SetClaimsIssuer(string issuer) { ArgumentException.ThrowIfNullOrEmpty(issuer); Registration.ClaimsIssuer = issuer; return this; } /// /// Sets the provider name. /// /// The provider name. /// The instance. public {{ provider.name }} SetProviderName(string name) { ArgumentException.ThrowIfNullOrEmpty(name); Registration.ProviderName = name; return this; } /// /// Sets the provider display name. /// /// The provider display name. /// The instance. public {{ provider.name }} SetProviderDisplayName(string name) { ArgumentException.ThrowIfNullOrEmpty(name); Registration.ProviderDisplayName = name; return this; } /// /// Sets the registration identifier. /// /// The registration identifier. /// The instance. public {{ provider.name }} SetRegistrationId(string identifier) { ArgumentException.ThrowIfNullOrEmpty(identifier); Registration.RegistrationId = identifier; return this; } /// /// Sets the client identifier. /// /// The client identifier. /// The instance. public {{ provider.name }} SetClientId(string identifier) { ArgumentException.ThrowIfNullOrEmpty(identifier); Registration.ClientId = identifier; return this; } /// /// Sets the client secret, if applicable. /// /// The client secret. /// The instance. public {{ provider.name }} SetClientSecret(string secret) { ArgumentException.ThrowIfNullOrEmpty(secret); Registration.ClientSecret = secret; return this; } /// /// Sets the client type (typically, "public" or "confidential"). /// /// The client type. /// The instance. public {{ provider.name }} SetClientType(string type) { ArgumentException.ThrowIfNullOrEmpty(type); Registration.ClientType = type; return this; } /// /// Sets the post-logout redirection URI, if applicable. /// /// /// Note: the post-logout redirection URI is automatically added to /// . /// /// The post-logout redirection URI. /// The instance. public {{ provider.name }} SetPostLogoutRedirectUri(Uri uri) { ArgumentNullException.ThrowIfNull(uri); Registration.PostLogoutRedirectUri = uri; return this; } /// /// Sets the post-logout redirection URI, if applicable. /// /// /// Note: the post-logout redirection URI is automatically added to /// . /// /// The post-logout redirection URI. /// The instance. public {{ provider.name }} SetPostLogoutRedirectUri([StringSyntax(StringSyntaxAttribute.Uri)] string uri) { ArgumentException.ThrowIfNullOrEmpty(uri); return SetPostLogoutRedirectUri(new Uri(uri, UriKind.RelativeOrAbsolute)); } /// /// Sets the redirection URI, if applicable. /// /// /// Note: the redirection URI is automatically added to /// . /// /// The redirection URI. /// The instance. public {{ provider.name }} SetRedirectUri(Uri uri) { ArgumentNullException.ThrowIfNull(uri); Registration.RedirectUri = uri; return this; } /// /// Sets the redirection URI, if applicable. /// /// /// Note: the redirection URI is automatically added to /// . /// /// The redirection URI. /// The instance. public {{ provider.name }} SetRedirectUri([StringSyntax(StringSyntaxAttribute.Uri)] string uri) { ArgumentException.ThrowIfNullOrEmpty(uri); return SetRedirectUri(new Uri(uri, UriKind.RelativeOrAbsolute)); } {% for environment in provider.environments %} /// /// Configures the provider to use the "{{ environment.name }}" environment. /// /// The instance. public {{ provider.name }} Use{{ environment.name }}Environment() { Registration.Get{{ provider.name }}Settings().Environment = OpenIddictClientWebIntegrationConstants.{{ provider.name }}.Environments.{{ environment.name }}; return this; } {% endfor %} {% for setting in provider.settings %} {% if setting.collection %} /// /// Configures {{ setting.description }}. /// /// {{ setting.description | slice: 0 | upcase }}{{ setting.description | slice: 1, setting.description.size }}. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Add{{ setting.property_name }}(params {{ setting.clr_type }}[] {{ setting.parameter_name }}) { ArgumentNullException.ThrowIfNull({{ setting.parameter_name }}); Registration.Get{{ provider.name }}Settings().{{ setting.property_name }}.UnionWith({{ setting.parameter_name }}); return this; } {% else %} {% case setting.clr_type %} {% when 'ECDsaSecurityKey' %} /// /// Configures {{ setting.description }}. /// /// {{ setting.description | slice: 0 | upcase }}{{ setting.description | slice: 1, setting.description.size }}. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(ECDsaSecurityKey {{ setting.parameter_name }}) { ArgumentNullException.ThrowIfNull({{ setting.parameter_name }}); if ({{ setting.parameter_name }}.PrivateKeyStatus is PrivateKeyStatus.DoesNotExist) { throw new ArgumentException(SR.GetResourceString(SR.ID0055), nameof({{ setting.parameter_name }})); } Registration.Get{{ provider.name }}Settings().{{ setting.property_name }} = {{ setting.parameter_name }}; return this; } #if NET /// /// Configures {{ setting.description }}. /// /// /// The PEM-encoded Elliptic Curve Digital Signature Algorithm (ECDSA) signing key. /// /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(string key) => Set{{ setting.property_name }}(key.AsMemory()); /// /// Configures {{ setting.description }}. /// /// /// The PEM-encoded Elliptic Curve Digital Signature Algorithm (ECDSA) signing key. /// /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(ReadOnlyMemory key) => Set{{ setting.property_name }}(key.Span); /// /// Configures {{ setting.description }}. /// /// /// The PEM-encoded Elliptic Curve Digital Signature Algorithm (ECDSA) signing key. /// /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(ReadOnlySpan key) { if (key.IsEmpty) { throw new ArgumentException(SR.GetResourceString(SR.ID0346), nameof(key)); } var algorithm = ECDsa.Create(); try { algorithm.ImportFromPem(key); } catch { algorithm.Dispose(); throw; } return Set{{ setting.property_name }}(new ECDsaSecurityKey(algorithm)); } #endif {% when 'Uri' %} /// /// Configures {{ setting.description }}. /// /// {{ setting.description | slice: 0 | upcase }}{{ setting.description | slice: 1, setting.description.size }}. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(Uri {{ setting.parameter_name }}) { ArgumentNullException.ThrowIfNull({{ setting.parameter_name }}); if (!{{ setting.parameter_name }}.IsAbsoluteUri || OpenIddictHelpers.IsImplicitFileUri({{ setting.parameter_name }})) { throw new ArgumentException(SR.GetResourceString(SR.ID0144), nameof({{ setting.parameter_name }})); } Registration.Get{{ provider.name }}Settings().{{ setting.property_name }} = {{ setting.parameter_name }}; return this; } /// /// Configures {{ setting.description }}. /// /// {{ setting.description | slice: 0 | upcase }}{{ setting.description | slice: 1, setting.description.size }}. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(string {{ setting.parameter_name }}) { ArgumentException.ThrowIfNullOrEmpty({{ setting.parameter_name }}); return Set{{ setting.property_name }}(new Uri({{ setting.parameter_name }}, UriKind.RelativeOrAbsolute)); } {% when 'X509Certificate2' %} /// /// Configures {{ setting.description }}. /// /// {{ setting.description | slice: 0 | upcase }}{{ setting.description | slice: 1, setting.description.size }}. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(X509Certificate2 {{ setting.parameter_name }}) { ArgumentNullException.ThrowIfNull({{ setting.parameter_name }}); if (!{{ setting.parameter_name }}.HasPrivateKey) { throw new ArgumentException(SR.GetResourceString(SR.ID0061), nameof({{ setting.parameter_name }})); } Registration.Get{{ provider.name }}Settings().{{ setting.property_name }} = {{ setting.parameter_name }}; return this; } /// /// Configures {{ setting.description }}. /// /// The assembly containing the certificate. /// The name of the embedded resource. /// The password used to open the certificate. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(Assembly assembly, string resource, string? password) // Note: ephemeral key sets are currently not supported on macOS. => Set{{ setting.property_name }}(assembly, resource, password, OperatingSystem.IsMacOS() ? X509KeyStorageFlags.MachineKeySet : X509KeyStorageFlags.EphemeralKeySet); /// /// Configures {{ setting.description }}. /// /// The assembly containing the certificate. /// The name of the embedded resource. /// The password used to open the certificate. /// An enumeration of flags indicating how and where to store the private key of the certificate. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}( Assembly assembly, string resource, string? password, X509KeyStorageFlags flags) { ArgumentNullException.ThrowIfNull(assembly); ArgumentException.ThrowIfNullOrEmpty(resource); using var stream = assembly.GetManifestResourceStream(resource) ?? throw new InvalidOperationException(SR.GetResourceString(SR.ID0064)); return Set{{ setting.property_name }}(stream, password, flags); } /// /// Configures {{ setting.description }}. /// /// The stream containing the certificate. /// The password used to open the certificate. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(Stream stream, string? password) // Note: ephemeral key sets are currently not supported on macOS. => Set{{ setting.property_name }}(stream, password, OperatingSystem.IsMacOS() ? X509KeyStorageFlags.MachineKeySet : X509KeyStorageFlags.EphemeralKeySet); /// /// Configures {{ setting.description }}. /// /// The stream containing the certificate. /// The password used to open the certificate. /// An enumeration of flags indicating how and where to store the private key of the certificate. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(Stream stream, string? password, X509KeyStorageFlags flags) { ArgumentNullException.ThrowIfNull(stream); using var buffer = new MemoryStream(); stream.CopyTo(buffer); var certificate = X509Certificate2.GetCertContentType(buffer.ToArray()) switch { X509ContentType.Pkcs12 => X509CertificateLoader.LoadPkcs12(buffer.ToArray(), password, flags), _ => throw new InvalidOperationException(SR.GetResourceString(SR.ID0454)) }; return Set{{ setting.property_name }}(certificate); } /// /// Configures {{ setting.description }}. /// /// The thumbprint of the certificate used to identify it in the X.509 store. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} [UnsupportedOSPlatform("linux")] public {{ provider.name }} Set{{ setting.property_name }}(string thumbprint) { ArgumentException.ThrowIfNullOrEmpty(thumbprint); return Set{{ setting.property_name }}( GetCertificate(StoreLocation.CurrentUser, thumbprint) ?? GetCertificate(StoreLocation.LocalMachine, thumbprint) ?? throw new InvalidOperationException(SR.GetResourceString(SR.ID0066))); static X509Certificate2? GetCertificate(StoreLocation location, string thumbprint) { using var store = new X509Store(StoreName.My, location); store.Open(OpenFlags.ReadOnly); return store.Certificates.Find(X509FindType.FindByThumbprint, thumbprint, validOnly: false) .Cast() .SingleOrDefault(); } } /// /// Configures {{ setting.description }}. /// /// The thumbprint of the certificate used to identify it in the X.509 store. /// The name of the X.509 store. /// The location of the X.509 store. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(string thumbprint, StoreName name, StoreLocation location) { ArgumentException.ThrowIfNullOrEmpty(thumbprint); using var store = new X509Store(name, location); store.Open(OpenFlags.ReadOnly); return Set{{ setting.property_name }}( store.Certificates.Find(X509FindType.FindByThumbprint, thumbprint, validOnly: false) .Cast() .SingleOrDefault() ?? throw new InvalidOperationException(SR.GetResourceString(SR.ID0066))); } {% when 'bool' %} /// /// Configures {{ setting.description }}. /// /// {{ setting.description | slice: 0 | upcase }}{{ setting.description | slice: 1, setting.description.size }}. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}(bool {{ setting.parameter_name }}) { Registration.Get{{ provider.name }}Settings().{{ setting.property_name }} = {{ setting.parameter_name }}; return this; } {% else %} /// /// Configures {{ setting.description }}. /// /// {{ setting.description | slice: 0 | upcase }}{{ setting.description | slice: 1, setting.description.size }}. /// The instance. {% if setting.obsolete -%} [Obsolete("This option is no longer supported and will be removed in a future version.")] {% endif -%} public {{ provider.name }} Set{{ setting.property_name }}({{ setting.clr_type }} {{ setting.parameter_name }}) { ArgumentNullException.ThrowIfNull({{ setting.parameter_name }}); Registration.Get{{ provider.name }}Settings().{{ setting.property_name }} = {{ setting.parameter_name }}; return this; } {% endcase %} {% endif %} {% endfor %} /// [EditorBrowsable(EditorBrowsableState.Never)] public override bool Equals([NotNullWhen(true)] object? obj) => base.Equals(obj); /// [EditorBrowsable(EditorBrowsableState.Never)] public override int GetHashCode() => base.GetHashCode(); /// [EditorBrowsable(EditorBrowsableState.Never)] public override string? ToString() => base.ToString(); } {% endfor %} }