fix(Builders): Added fluent builders for the newly added authentications

Signed-off-by: Charles d'Avernas <[email protected]>

Author: cdavernas

src/ServerlessWorkflow.Sdk.Builders/AuthenticationPolicyDefinitionBuilder.cs

@@ -53,6 +53,22 @@ public virtual IBearerAuthenticationSchemeDefinitionBuilder Bearer()
         return builder;
     }
 
+    /// <inheritdoc/>
+    public virtual ICertificateAuthenticationSchemeDefinitionBuilder Certificate()
+    {
+        var builder = new CertificateAuthenticationSchemeDefinitionBuilder();
+        this.SchemeBuilder = builder;
+        return builder;
+    }
+
+    /// <inheritdoc/>
+    public virtual IDigestAuthenticationSchemeDefinitionBuilder Digest()
+    {
+        var builder = new DigestAuthenticationSchemeDefinitionBuilder();
+        this.SchemeBuilder = builder;
+        return builder;
+    }
+
     /// <inheritdoc/>
     public virtual IOAuth2AuthenticationSchemeDefinitionBuilder OAuth2()
     {
@@ -61,6 +77,14 @@ public virtual IOAuth2AuthenticationSchemeDefinitionBuilder OAuth2()
         return builder;
     }
 
+    /// <inheritdoc/>
+    public virtual IOpenIDConnectAuthenticationSchemeDefinitionBuilder OpenIDConnect()
+    {
+        var builder = new OpenIDConnectAuthenticationSchemeDefinitionBuilder();
+        this.SchemeBuilder = builder;
+        return builder;
+    }
+
     /// <inheritdoc/>
     public virtual AuthenticationPolicyDefinition Build()
     {
@@ -72,6 +96,7 @@ public virtual AuthenticationPolicyDefinition Build()
             Basic = scheme is BasicAuthenticationSchemeDefinition basic ? basic : null,
             Bearer = scheme is BearerAuthenticationSchemeDefinition bearer ? bearer : null,
             OAuth2 = scheme is OAuth2AuthenticationSchemeDefinition oauth2 ? oauth2 : null,
+            Oidc = scheme is OpenIDConnectSchemeDefinition oidc ? oidc : null
         };
     }
 

src/ServerlessWorkflow.Sdk.Builders/CertificateAuthenticationSchemeDefinitionBuilder.cs

@@ -0,0 +1,34 @@
+// Copyright © 2024-Present The Serverless Workflow Specification Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License"),
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+namespace ServerlessWorkflow.Sdk.Builders;
+
+/// <summary>
+/// Represents the default implementation of the <see cref="ICertificateAuthenticationSchemeDefinitionBuilder"/> interface
+/// </summary>
+public class CertificateAuthenticationSchemeDefinitionBuilder
+    : AuthenticationSchemeDefinitionBuilder<CertificateAuthenticationSchemeDefinition>, ICertificateAuthenticationSchemeDefinitionBuilder
+{
+
+    /// <inheritdoc/>
+    public override CertificateAuthenticationSchemeDefinition Build()
+    {
+        return new()
+        {
+            Use = this.Secret
+        };
+    }
+
+    AuthenticationSchemeDefinition IAuthenticationSchemeDefinitionBuilder.Build() => this.Build();
+
+}

src/ServerlessWorkflow.Sdk.Builders/DigestAuthenticationSchemeDefinitionBuilder.cs

@@ -0,0 +1,64 @@
+// Copyright © 2024-Present The Serverless Workflow Specification Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License"),
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+namespace ServerlessWorkflow.Sdk.Builders;
+
+/// <summary>
+/// Represents the default implementation of the <see cref="IDigestAuthenticationSchemeDefinitionBuilder"/> interface
+/// </summary>
+public class DigestAuthenticationSchemeDefinitionBuilder
+    : AuthenticationSchemeDefinitionBuilder<DigestAuthenticationSchemeDefinition>, IDigestAuthenticationSchemeDefinitionBuilder
+{
+
+    /// <summary>
+    /// Gets/sets the username to use
+    /// </summary>
+    protected string? Username { get; set; }
+
+    /// <summary>
+    /// Gets/sets the password to use
+    /// </summary>
+    protected string? Password { get; set; }
+
+    /// <inheritdoc/>
+    public virtual IDigestAuthenticationSchemeDefinitionBuilder WithUsername(string username)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(username);
+        this.Username = username;
+        return this;
+    }
+
+    /// <inheritdoc/>
+    public virtual IDigestAuthenticationSchemeDefinitionBuilder WithPassword(string password)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(password);
+        this.Password = password;
+        return this;
+    }
+
+    /// <inheritdoc/>
+    public override DigestAuthenticationSchemeDefinition Build()
+    {
+        if (string.IsNullOrWhiteSpace(this.Username)) throw new NullReferenceException("The username must be set");
+        if (string.IsNullOrWhiteSpace(this.Password)) throw new NullReferenceException("The password must be set");
+        return new()
+        {
+            Use = this.Secret,
+            Username = this.Username,
+            Password = this.Password
+        };
+    }
+
+    AuthenticationSchemeDefinition IAuthenticationSchemeDefinitionBuilder.Build() => this.Build();
+
+}

src/ServerlessWorkflow.Sdk.Builders/Interfaces/IAuthenticationPolicyDefinitionBuilder.cs

@@ -37,12 +37,30 @@ public interface IAuthenticationPolicyDefinitionBuilder
     /// <returns>A new <see cref="IBasicAuthenticationSchemeDefinitionBuilder"/></returns>
     IBearerAuthenticationSchemeDefinitionBuilder Bearer();
 
+    /// <summary>
+    /// Configures the policy to use 'Certificate' authentication
+    /// </summary>
+    /// <returns>A new <see cref="ICertificateAuthenticationSchemeDefinitionBuilder"/></returns>
+    ICertificateAuthenticationSchemeDefinitionBuilder Certificate();
+
+    /// <summary>
+    /// Configures the policy to use 'Digest' authentication
+    /// </summary>
+    /// <returns>A new <see cref="IDigestAuthenticationSchemeDefinitionBuilder"/></returns>
+    IDigestAuthenticationSchemeDefinitionBuilder Digest();
+
     /// <summary>
     /// Configures the policy to use 'OAuth2' authentication
     /// </summary>
     /// <returns>A new <see cref="IBasicAuthenticationSchemeDefinitionBuilder"/></returns>
     IOAuth2AuthenticationSchemeDefinitionBuilder OAuth2();
 
+    /// <summary>
+    /// Configures the policy to use 'OpenIDConnect' authentication
+    /// </summary>
+    /// <returns>A new <see cref="IOpenIDConnectAuthenticationSchemeDefinitionBuilder"/></returns>
+    IOpenIDConnectAuthenticationSchemeDefinitionBuilder OpenIDConnect();
+
     /// <summary>
     /// Builds the configured <see cref="AuthenticationPolicyDefinition"/>
     /// </summary>

src/ServerlessWorkflow.Sdk.Builders/Interfaces/ICertificateAuthenticationSchemeDefinitionBuilder.cs

@@ -0,0 +1,25 @@
+// Copyright © 2024-Present The Serverless Workflow Specification Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License"),
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+namespace ServerlessWorkflow.Sdk.Builders;
+
+/// <summary>
+/// Defines the fundamentals of a service used to build <see cref="CertificateAuthenticationSchemeDefinition"/>s
+/// </summary>
+public interface ICertificateAuthenticationSchemeDefinitionBuilder
+    : IAuthenticationSchemeDefinitionBuilder<CertificateAuthenticationSchemeDefinition>
+{
+
+
+
+}

src/ServerlessWorkflow.Sdk.Builders/Interfaces/IDigestAuthenticationSchemeDefinitionBuilder.cs

@@ -0,0 +1,37 @@
+// Copyright © 2024-Present The Serverless Workflow Specification Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License"),
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+namespace ServerlessWorkflow.Sdk.Builders;
+
+/// <summary>
+/// Defines the fundamentals of a service used to build <see cref="DigestAuthenticationSchemeDefinition"/>s
+/// </summary>
+public interface IDigestAuthenticationSchemeDefinitionBuilder
+    : IAuthenticationSchemeDefinitionBuilder<DigestAuthenticationSchemeDefinition>
+{
+
+    /// <summary>
+    /// Sets the username to use
+    /// </summary>
+    /// <param name="username">The username to use</param>
+    /// <returns>The configured <see cref="IDigestAuthenticationSchemeDefinitionBuilder"/></returns>
+    IDigestAuthenticationSchemeDefinitionBuilder WithUsername(string username);
+
+    /// <summary>
+    /// Sets the password to use
+    /// </summary>
+    /// <param name="password">The password to use</param>
+    /// <returns>The configured <see cref="IDigestAuthenticationSchemeDefinitionBuilder"/></returns>
+    IDigestAuthenticationSchemeDefinitionBuilder WithPassword(string password);
+
+}

src/ServerlessWorkflow.Sdk.Builders/Interfaces/IOAuth2AuthenticationClientDefinitionBuilder.cs

@@ -33,6 +33,20 @@ public interface IOAuth2AuthenticationClientDefinitionBuilder
     /// <returns>The configured <see cref="IOAuth2AuthenticationClientDefinitionBuilder"/></returns>
     IOAuth2AuthenticationClientDefinitionBuilder WithSecret(string secret);
 
+    /// <summary>
+    /// Sets the OAUTH2 client's assertion
+    /// </summary>
+    /// <param name="assertion">A JWT containing a signed assertion with the application credentials</param>
+    /// <returns>The configured <see cref="IOAuth2AuthenticationClientDefinitionBuilder"/></returns>
+    IOAuth2AuthenticationClientDefinitionBuilder WithAssertion(string assertion);
+
+    /// <summary>
+    /// Sets the OAUTH2 client's authentication method
+    /// </summary>
+    /// <param name="method">The authentication method to use to authenticate the client</param>
+    /// <returns>The configured <see cref="IOAuth2AuthenticationClientDefinitionBuilder"/></returns>
+    IOAuth2AuthenticationClientDefinitionBuilder WithAuthenticationMethod(string method);
+
     /// <summary>
     /// Builds the configured <see cref="OAuth2AuthenticationClientDefinition"/>
     /// </summary>

src/ServerlessWorkflow.Sdk.Builders/Interfaces/IOAuth2AuthenticationEndpointsDefinitionBuilder.cs

@@ -0,0 +1,49 @@
+// Copyright © 2024-Present The Serverless Workflow Specification Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License"),
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+namespace ServerlessWorkflow.Sdk.Builders;
+
+/// <summary>
+/// Defines the fundamentals of a service used to build <see cref="OAuth2AuthenticationEndpointsDefinition"/>s
+/// </summary>
+public interface IOAuth2AuthenticationEndpointsDefinitionBuilder
+{
+
+    /// <summary>
+    /// Configures the <see cref="OAuth2AuthenticationEndpointsDefinition"/> to build to use the specified token endpoint relative uri
+    /// </summary>
+    /// <param name="uri">The relative uri of the token endpoint to use</param>
+    /// <returns>The configured <see cref="IOAuth2AuthenticationEndpointsDefinitionBuilder"/></returns>
+    IOAuth2AuthenticationEndpointsDefinitionBuilder WithTokenEndpoint(Uri uri);
+
+    /// <summary>
+    /// Configures the <see cref="OAuth2AuthenticationEndpointsDefinition"/> to build to use the specified revocation endpoint relative uri
+    /// </summary>
+    /// <param name="uri">The relative uri of the revocation endpoint to use</param>
+    /// <returns>The configured <see cref="IOAuth2AuthenticationEndpointsDefinitionBuilder"/></returns>
+    IOAuth2AuthenticationEndpointsDefinitionBuilder WithRevocationEndpoint(Uri uri);
+
+    /// <summary>
+    /// Configures the <see cref="OAuth2AuthenticationEndpointsDefinition"/> to build to use the specified introspection endpoint relative uri
+    /// </summary>
+    /// <param name="uri">The relative uri of the introspection endpoint to use</param>
+    /// <returns>The configured <see cref="IOAuth2AuthenticationEndpointsDefinitionBuilder"/></returns>
+    IOAuth2AuthenticationEndpointsDefinitionBuilder WithIntrospectionEndpoint(Uri uri);
+
+    /// <summary>
+    /// Builds the configured <see cref="OAuth2AuthenticationEndpointsDefinition"/>
+    /// </summary>
+    /// <returns>The configured <see cref="OAuth2AuthenticationEndpointsDefinition"/></returns>
+    OAuth2AuthenticationEndpointsDefinition Build();
+
+}

src/ServerlessWorkflow.Sdk.Builders/Interfaces/IOAuth2AuthenticationRequestDefinitionBuilder.cs

@@ -0,0 +1,35 @@
+// Copyright © 2024-Present The Serverless Workflow Specification Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License"),
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+namespace ServerlessWorkflow.Sdk.Builders;
+
+/// <summary>
+/// Defines the fundamentals of a service used to build <see cref="OAuth2AuthenticationRequestDefinition"/>s
+/// </summary>
+public interface IOAuth2AuthenticationRequestDefinitionBuilder
+{
+
+    /// <summary>
+    /// Configures the <see cref="OAuth2AuthenticationRequestDefinition"/> to build to use the specified encoding
+    /// </summary>
+    /// <param name="encoding">The encoding to use</param>
+    /// <returns>The configured <see cref="IOAuth2AuthenticationRequestDefinitionBuilder"/></returns>
+    IOAuth2AuthenticationRequestDefinitionBuilder WithEncoding(string encoding);
+
+    /// <summary>
+    /// Builds the configured <see cref="OAuth2AuthenticationRequestDefinition"/>
+    /// </summary>
+    /// <returns>A new <see cref="OAuth2AuthenticationRequestDefinition"/></returns>
+    OAuth2AuthenticationRequestDefinition Build();
+
+}