Rules

Secret ingredients to quality software

Edit
Info

Rules to Better Security

6 Rules

Watch the best security videos on SSW TV for free.

  1. Do you choose the best method of authentication for your situation?

    Authentication and authorization are complicated, and it is risky to try and implement them yourself. Use this rule as a guide on choosing the right service or framework for your situation.

    Choosing the right authentication and authorization approach for your situation can be tricky. It is a multi-faceted problem with many variables, and what seems like the right choice in one situation may not be in the other.

    Start with the Questions

    1. Scope - Is it an enterprise application for internal users or a consumer application for external use?
    2. Social - Do you need to support

    3. MFA - Do you need to support

    4. Scope - Do you need to share the identity across multiple applications?
    5. Volume - Do you have an estimate for how many users you need to support?
    6. Complexity - do you need custom logic to run as part of your authentication process?

    Without the answers to these questions, it will be difficult to choose the right option. With the answers to these questions, you can use the flow charts below to help you choose the right solution.

    Your situation is unique, and every application's requirements are different. These flow charts are intended to point you towards what you should consider for your solution.

    External Applications

    External applications are B2B or B2C applications that are intended for consumption outside of your organization.

    external auth decision flow
    Figure: WebAPI (Public facing/consumer Application) - Authentication selection flow chart

    Example Template to Customer:

    Scenario:

    Scope - You are building a consumer facing service that will have multiple clients, including a SPA and a mobile app.
    Social - You want to allow your users to sign up with their social identities (Google, Facebook, Twitter, etc.) but want to allow them to create an account with you if they don't have a social login or don't want to use it.
    All users will have the same level of access once logged in.
    Volume - You anticipate 20,000 active users.
    MFA - You would like to allow users to enable MFA.

    Your choices:

    • Option A (Recommended) - Azure AD B2C - B2C provides all of the functionality you need and is free for up to 50,000 monthly users.
    • Option B - Auth0 - Auth0 will meet most of these requirements, however, your volume of users will exceed the free tier and you don't need the additional functionality of the paid tier.
    • Option C - Identity Server - This would work but adds additional management overhead and complexity. You would also need to manage scaling to cope with your volume of users.

    Good Example: The chosen solution meets the requirements and is highlighted as per Do you manage up?

    Internal Applications

    For internal applications, the below flow chart is intended to assist your decision by guiding you to which option or options to consider for your application. It is possible (and in some cases necessary) to use combinations of these.

    internal auth decision flowv2
    Figure: WebAPI (Internal Enterprise Application) - Authentication selection flow chart

    Example Template to Customer:

    Scenario:

    Scope - You have an internal enterprise application, which will support approximately 1,000 users.
    You already have Active Directory in place and are syncing with an Azure AD tenant.
    Your users will need to access this application from anywhere.
    MFA - As per your company security policy, you must enforce MFA.

    Your choices:

    • Option A (Recommended) - Azure Active Directory - most of the infrastructure for this is already in place for you, and it already meets all your requirements. We would just need to wire up your application to it.
    • Option B - Active Directory - while your users are already in AD, it doesn't give you MFA or access outside your network.
    • Option C - Okta - this is an expensive option which for this scenario, doesn't provide any advantages over Azure AD.

    Good Example: The chosen solution meets the requirements without adding unnecessary additional costs

    Note #1: All of the following options assume you are building an ASP.NET Core application, although the commercial options listed here provide libraries for most development languages, frameworks, and platforms.

    Note #2: The information here is relevant as provided, but consider other factors that may impact your decision too. For example, cost may be a factor and saving money may be more important than the added benefits of higher-cost options. Additionally, your situation may not fit neatly into one of the scenarios we have listed and may span multiple scenarios, in which case you may need to pick the option which caters to the broadest set of requirements (avoid 'mix and match').

    ASP.NET Core Identity (simple and free)

    ASP.NET Core has some built-in identity functionality that allows you to create users and roles, and manage the security of your web applications. It is extremely capable and can be used to support a broad number of scenarios. However, it is intended for use in simple web applications, and while it can be extended to support other clients, you will need to build and wire up a lot of the UI for these scenarios yourself. Your identity store will be limited to this one application, so your users will not be able to share this identity across multiple applications.

    Advantages:

    • Free
    • Easy to set up and use
    • Supports OAuth2/OIDC providers

    Disadvantages:

    • It is recommended by Microsoft that for advanced requirements you don't use this on its own - so need to add one of the below
    • Does not scale well across multiple applications - so need to add one of the below
    • For anything other than an ASP.NET Core Web app (e.g. Angular, React, or mobile), you have to build all UI yourself, such as: sign up, log, password reset, etc.

    Use this option if...

    • You need to add identity to a simple ASP.NETapplication

    Identity Server (full control)

    Identity Server is an open-source solution that is built on top of ASP.NET Core Identity. It has extensive support for a number of authentication and authorization scenarios and supports multiple identity providers (OAuth2/OIDC) out of the box. Identity Server extends ASP.NET Core Identity to natively support multiple client types and can be used as a single identity across multiple applications.

    Identity Server is a powerful authentication solution and its core strengths are its ability to inject complex, custom logic into your authentication flow and integrate with legacy systems. If you have either of these requirements, it's likely IdenityServer will form an essential part of your solution.

    Advantages:

    • Inexpensive
    • Allows you to define custom authentication logic
    • Supports multiple applications/identity consumers
    • Supports multiple clients and client types
    • Supports OAuth/OIDC

    Disadvantages:

    • Steep learning curve
    • Requires additional setup
    • Requires additional skillset
    • Requires additional management

    Use this option if...

    • You need to inject custom logic into your authentication flow, or:
    • You expect to support multiple clients (e.g. web, mobile, etc), and/or:
    • You expect to support multiple applications

    Active Directory (for Internal Enterprise Applications)

    Active Directory has been the de facto enterprise identity store for most of the world for decades. Many organizations already have AD as it provides a lot of additional capability and is integrated with most of their existing enterprise applications. AD supports multiple authentication protocols, including:

    • LDAP/LDAPS: simple to use but old tech, requires multiple queries to check permissions, roles not natively supported, and need to be managed by groups.
    • Kerberos: Excellent experience for users as it provides a silent and transparent login. But can only be used for on-premises, domain-joined computers.
    • ADFS/SAML: Modern application authentication against AD is done via ADFS with SAML. This is often extended through third-party tools such as Okta to support applications that use JWT and claims.
    • Proprietary Microsoft: Basic, NTLM, etc.

    Advantages

    • Already in place in most enterprise organizations
    • Users do not require an additional identity
    • Can make the application compliant with the organization's existing security policies

    Disadvantages

    • Not suited to external use
    • Can require a lot of setups to work well with company RBAC (e.g. AD groups for authorization)
    • Not natively supported off-premises
    • No MFA included

    Use this option if...

    • Your application, domain controllers, and clients are all on the same network, and:
    • You already have AD in place and have a security policy that states that all your users must authenticate against your centralized corporate identity, and/or:
    • You want to enable pass-through/silent authentication for your users

    Azure AD (for Internal Enterprise Applications)

    Azure AD is Microsoft's cloud-based version of its traditional on-premises enterprise identity store - Active Directory. Azure AD is different in that it is fundamentally identity only (it doesn't provide endpoint and user management features such as Group Policy) and as such provides strong identity features not natively supported by AD, such as MFA and self-service password recovery. Being cloud-based, it can authenticate users anywhere in the world (rather than just on-premises on corporate computers).

    Advantages

    • Many organizations already have AAD
    • Extends existing enterprise identity to the cloud (i.e. is supported off-premises)
    • Can be used to ensure compliance with existing company security policies
    • MFA support included

    Disadvantages

    • Not suited for external or consumer-facing uses

    Use this option if...

    • You want to support internal/enterprise users, and:
    • You already have Azure AD set up, and/or:
    • Your users require access from off-site, and/or:
    • You need to enforce MFA

    Azure B2C (simple Auth as a Service)

    AAD B2C sits on top of Azure AD and includes all the benefits it provides, as well as enabling consumer-friendly features. These include integration with OAuth2/OIDC provider and more flexible/customizable login flows. B2C is well-tailored to support authentication, and while it can be extended to support additional capabilities, this requires custom development.

    Advantages

    • Inexpensive and generous free tier
    • Native support for multiple OAuth2/OIDC providers
    • MFA support included
    • Relatively straightforward to setup
    • Ongoing security maintained by Microsoft

    Disadvantages

    • Very limited flexibility
    • Can support roles and other extended functionality, but requires significant development

    Use this option if...

    • You want to support MFA, and/or:
    • Your users are external/consumers, and:
    • You anticipate a high volume of users, and/or:
    • You only require basic authentication and limited or no authorization

    Auth0 (sophisticated Auth as a Service)

    Auth0 is a commercial identity product aimed at developers. It is cloud-hosted and offers out-of-the-box functionality for user signup and login, self-service password recovery, OAuth2/OIDC integration, and other consumer and user-friendly features. MFA is supported out of the box, and significant sophisticated functionality is available on the paid tiers.

    Advantages

    • Good free tier
    • Very easy to set up and use
    • MFA support included
    • Supports multiple OAuth2/OIDC providers
    • Significant extensibility

    Disadvantages

    • Free tier is more limited in volume than competition (B2C)
    • Free tier only includes the basic functionality (same as B2C)
    • Free tier only supports 2 social identity providers

    Use this option if...

    • You want to enforce MFA, and/or:
    • Your users are external/consumers, and/or:
    • You require authorization or complex authentication

    Okta (for Commercial Enterprise Applications $)

    Okta is a commercial identity product aimed at enterprises. Many enterprise-centric software products, for example, Salesforce, have Okta connectors. Okta is intended to bridge the gap between enterprise authentication (such as AD) and modern software and SaaS products.

    Advantages

    • Integrates with anything
    • Very well supported in the enterprise
    • Can simplify integration with AD

    Disadvantages

    • Expensive
    • No free tier
    • Not suited to consumer-facing scenarios

    Use this option if...

    • Your application is for internal/enterprise users, and:
    • You already have Okta in place, and/or:
    • Your application is a product that you intend to commercialize (Okta is prevalent in the enterprise and having an Okta connector is a good selling point)

    Roll your own - a solution looking for a problem :-)

    It is entirely possible to create a users table and a roles table in your database and create and manage users yourself.

    Advantages:

    • Developers feel like they're ninjas for a little while
    • Can be a quick and dirty solution to the absolute most basic situation

    Disadvantages:

    • You have to reinvent the wheel
    • Identity
    • Roles
    • Email verification
    • Login/Signup/Password reset
    • Claims management
    • Significant risk
    • High maintenance overhead
    • Masses of technical debt

    Use this option if...

    • You want a side project to learn more about how you might roll your own, but of course, you know never intend to put it into production :-)
  2. Do you use a finger scanner to monitor access to secure areas?

    Do you know who is entering your premises, when and how? Keys or key-cards can be expensive, they can be lost and people can loan them to one another without any restriction.

    Finger scanners are a good way of monitoring and restricting access to secure areas. As every person’s fingerprint is unique, so is the access to your building. There is no physical mechanism for unlocking the doors, which means you do not have to worry about lost keys or unauthorized access and it can keep a log of entry.

    SSW uses an Invixium fingerprint scanner. The user interface is easy to use, you simply hold your finger down on the screen and it will either allow or deny you access. Other fingerprint scanners like E-Key use a swipe function that is less intuitive for visitors.

    The Invixium integrates well with our Control4 Automation system.

    Scanner 2
    Bad example - E-Key needs you to swipe your finger down, this is less intuitive

    Scanner 1
    Good example - Invixium is easy to use, just hold down your finger on the screen to scan

    See Better Software Suggestions for Control4.

  3. Does your team understand the dangers of social engineering?

    As developers when we think security we commonly become fixated with issues in the code, out of date software versions or incorrectly configured firewalls. However, we miss one glaring vulnerability which there is no patch for... our users.

    Social engineering is a technique which mixes art and science to exploit common human behaviours to compromise information systems. The following is a classic example of social engineering performed over the phone.

    There are numerous examples of social engineering ranging from phone calls, attackers posing as friends on social media, all the way to sophisticated attempts at phishing users with near-perfect clones of popular websites.

    social eng
    Figure: ‘Do you think the average consumer could spot the phishing site?’ Source: Troy Hunt

    The only solution to social engineering is to train properly and prepare users about the dangers presented by and common techniques used by malicious individuals. For useful information on the topic reference the document ‘Avoiding Social Engineering and Phishing Attacks’ by the United States Computer Emergency Readiness Team or the Pluralsight course Ethical Hacking: Social Engineering by Troy Hunt.

    With the above in mind, it is important to review regularly the information availed via search engines and standard operating procedures. Furthermore, it can be useful to test the readiness and alertness of staff by performing mock social engineering attacks.

    Take the following situation as an example: the CEO is out of town and decides to use an employee’s laptop left in the office on the weekend, the employee in question is messaged via Skype for their domain password. If the employee is aware of the risks, this poses the company then they would not send the requested credentials and follow proper procedure around reporting a suspected incident.

  4. Do you follow Security Checklists?

    The following checklist is a good example of areas to focus on:

    • Run penetration tests with SSLLabs.com to check how exposed your servers are
    • Look for passwords in .config and code (SSW Code Auditor can help)
    • Authentication process of identifying who the user is
    • Authorization what the user can do within the application
    • Licensing to control the usage of the software
    • Validation of all inputs in the system (cross site scripting (XSS) and SQL injection)
    • No in memory generation of SQL statements (and are they using a good ORM)
    • Encryption of passwords and any sensitive data
    • Software Licensing protection mechanisms (and a recommendation to a subscription model)
    • Methodologies and best practices to reduce your exposure to hostile attacks
    • Logging who is doing what and when (audit trails)

    There is a more comprehensive list here on GitHub: A practical security guide for web developers.

  5. Do you use Automatic Key management with Duende IdentityServer?

    When using IdentityServer 5 (aka Duende IdentityServer), you don't need to use UseDeveloperSigningCredentials() anymore as it is now enabled by default.

    services.AddIdentityServer()
        .AddInMemoryClients(new List<Client>())
        .AddInMemoryIdentityResources(new List<IdentityResource>())
        .AddInMemoryApiResources(new List<ApiResource>())
        .AddInMemoryApiScopes(new List<ApiScope>())
        .AddTestUsers(new List<TestUser>())
        .AddDeveloperSigningCredential();

    Figure: Bad example - you don't need to use .AddDevelopersSigningCredential() anymore

    When using version 5, instead of using IdentityServer4.AccessTokenValidation(), you should use the out of the box AddAuthentication(("Bearer").AddJwtBearer("Bearer") from .NET 5

    services.AddAuthentication("Bearer")
        .AddIdentityServerAuthentication("Bearer", options =>
        {
            options.ApiName = "api1";
            options.Authority = "https://localhost:5000";
        });

    Figure: Bad example - don't use IdentityServer4.AccessTokenValidation package as it is deprecated.

    services.AddAuthentication("Bearer") 
      .AddJwtBearer("Bearer", options =>
        {
          options.Audience = "api1";
          options.Authority = "https://localhost:5000";
        });

    Figure: Good example - use AddJwtBearer("Bearer") instead

  6. Do you disable insecure protocols?

    For better server security (especially regarding public facing servers), certain security protocols and ciphers should be disabled.

    Using a tool called "IIS Crypto 3.2" by Nartac, these protocols can be easily disabled instead of having to manually edit the Registry Keys.

    1. Download IIS Crypto 3.2 (https://www.nartac.com/Products/IISCrypto/Download)
    2. Run this on the server you wish to lock down
    3. Select the best practices button

    iis crypto 3 2
    Figure: Good example – TLS should be enabled and SSL should be disabled

    1. Ensure that TLS 1.0 and TLS 1.1 is also disabled | hit apply
    2. The server will need to be rebooted before the settings take effect
We open source. This page is on GitHub