OwinOAuthProviders/src/Owin.Security.Providers.Salesforce/SalesforceAuthenticationOptions.cs

using System;
using System.Collections.Generic;
using System.Net.Http;
using Microsoft.Owin;
using Microsoft.Owin.Security;

namespace Owin.Security.Providers.Salesforce
{
    public class SalesforceAuthenticationOptions : AuthenticationOptions
    {
        public class SalesforceAuthenticationEndpoints
        {
            /// <summary>
            /// Endpoint which is used to redirect users to request Salesforce access
            /// </summary>
            public string AuthorizationEndpoint { get; set; }

            /// <summary>
            /// Endpoint which is used to exchange code for access token
            /// </summary>
            public string TokenEndpoint { get; set; }

            /// <summary>
            /// Production or Sandbox. Use Constants.ProductionEnvironment or Constants.SandboxEnvironment
            /// </summary>
            public string Environment { get; set; }
        }

        /// <summary>
        /// Options for Display Mode
        ///     Changes the login and authorization pages’ display type. Salesforce supports these values.
        ///     page—Full-page authorization screen(default)
        ///     popup—Compact dialog optimized for modern web browser popup windows
        ///     touch—Mobile-optimized dialog designed for modern smartphones, such as Android and iPhone
        ///     mobile—Mobile-optimized dialog designed for less capable smartphones, such as BlackBerry OS 5
        /// </summary>
        public enum Display{
            page,
            popup,
            touch,
            mobile
        }
        
        /// <summary>
        ///     Gets or sets the a pinned certificate validator to use to validate the endpoints used
        ///     in back channel communications belong to Salesforce.
        /// </summary>
        /// <value>
        ///     The pinned certificate validator.
        /// </value>
        /// <remarks>
        ///     If this property is null then the default certificate checks are performed,
        ///     validating the subject name and if the signing chain is a trusted party.
        /// </remarks>
        public ICertificateValidator BackchannelCertificateValidator { get; set; }

        /// <summary>
        ///     The HttpMessageHandler used to communicate with Salesforce.
        ///     This cannot be set at the same time as BackchannelCertificateValidator unless the value
        ///     can be downcast to a WebRequestHandler.
        /// </summary>
        public HttpMessageHandler BackchannelHttpHandler { get; set; }

        /// <summary>
        ///     Gets or sets timeout value in milliseconds for back channel communications with Salesforce.
        /// </summary>
        /// <value>
        ///     The back channel timeout in milliseconds.
        /// </value>
        public TimeSpan BackchannelTimeout { get; set; }

        /// <summary>
        ///     The request path within the application's base path where the user-agent will be returned.
        ///     The middleware will process this request when it arrives.
        ///     Default value is "/signin-Salesforce".
        /// </summary>
        public PathString CallbackPath { get; set; }

        /// <summary>
        ///     Get or sets the text that the user can display on a sign in user interface.
        /// </summary>
        public string Caption
        {
            get { return Description.Caption; }
            set { Description.Caption = value; }
        }

        /// <summary>
        ///     Gets or sets the Salesforce supplied Client ID
        /// </summary>
        public string ClientId { get; set; }

        /// <summary>
        ///     Gets or sets the Salesforce supplied Client Secret
        /// </summary>
        public string ClientSecret { get; set; }

        /// <summary>
        /// Gets the sets of OAuth endpoints used to authenticate against Salesforce.  
        /// Overriding these endpoints allows you to use Salesforce Enterprise for authentication.
        /// </summary>
        public SalesforceAuthenticationEndpoints Endpoints { get; set; }

        /// <summary>
        ///     Gets or sets the <see cref="ISalesforceAuthenticationProvider" /> used in the authentication events
        /// </summary>
        public ISalesforceAuthenticationProvider Provider { get; set; }

        /// <summary>
        /// A list of permissions to request.
        /// </summary>
        public IList<string> Scope { get; private set; }

        /// <summary>
        /// Specifies how the authorization server prompts the user for reauthentication and reapproval. This parameter is optional. 
        /// The only values Salesforce supports are:
        /// login—The authorization server must prompt the user for reauthentication, forcing the user to log in again.
        /// consent—The authorization server must prompt the user for reapproval before returning information to the client.
        /// It is valid to pass both values, separated by a space, to require the user to both log in and reauthorize. 
        /// </summary>
        public string Prompt { get; set; }

        /// <summary>
        ///     Gets or sets the name of another authentication middleware which will be responsible for actually issuing a user
        ///     <see cref="System.Security.Claims.ClaimsIdentity" />.
        /// </summary>
        public string SignInAsAuthenticationType { get; set; }
        /// <summary>
        ///     Gets or sets the display—(Optional) 
        /// </summary>
        public Display DisplayMode { get; set; }

        /// <summary>
        ///     Gets or sets the type used to secure data handled by the middleware.
        /// </summary>
        public ISecureDataFormat<AuthenticationProperties> StateDataFormat { get; set; }

        /// <summary>
        ///     Initializes a new <see cref="SalesforceAuthenticationOptions" />
        /// </summary>
        public SalesforceAuthenticationOptions()
            : base("Salesforce")
        {
            Caption = Constants.DefaultAuthenticationType;
            CallbackPath = new PathString("/signin-salesforce");
            AuthenticationMode = AuthenticationMode.Passive;
            Scope = new List<string> { "id" };
            BackchannelTimeout = TimeSpan.FromSeconds(60);
            Endpoints = new SalesforceAuthenticationEndpoints
            {
                AuthorizationEndpoint = null,
                TokenEndpoint = null
            };
        }
    }
}