DomainVerifier.Extensions
1.0.0
dotnet add package DomainVerifier.Extensions --version 1.0.0
NuGet\Install-Package DomainVerifier.Extensions -Version 1.0.0
<PackageReference Include="DomainVerifier.Extensions" Version="1.0.0" />
paket add DomainVerifier.Extensions --version 1.0.0
#r "nuget: DomainVerifier.Extensions, 1.0.0"
// Install DomainVerifier.Extensions as a Cake Addin #addin nuget:?package=DomainVerifier.Extensions&version=1.0.0 // Install DomainVerifier.Extensions as a Cake Tool #tool nuget:?package=DomainVerifier.Extensions&version=1.0.0
domainverifier-dotnet
is a .NET library project designed to simplify domain name ownership verification.
It consists of two projects: DomainVerifier
and DomainVerifier.Extensions
.
The DomainVerifier
project is a .NET Standard 2.1 project that is compatible with .NET Core 3.0 to .NET 8. It provides core functionalities for generating domain verification codes and verifying domain ownership.
The DomainVerifier.Extensions
project provides integration with Dependency Injection and is compatible with .NET 6, 7, and 8.
DomainVerifier (the core library)
Installation
dotnet add package DomainVerifier
[!NOTE]
This package is specifically designed for integration with .NET projects running versions earlier than 6.0
If you are working with a .NET 6, 7, or 8 web or Api application, please install the DomainVerifier.Extensions
package instead like follow:
dotnet add package DomainVerifier.Extensions
Overview
The DomainVerifier
project includes a DnsRecordsGenerator
class that implements the DnsRecordsGenerator
interface as well as a DnsRecordsVerifier
class that implements the IDnsRecordsVerifier
interface. These classes offer convenient methods for generating domain verification codes and verifying ownership through DNS records(TXT and CNAME)
🔑 DnsRecordsGenerator
It can be injected into into your service class or controller using its interface or instantiated directly.
The DnsRecordsGenerator
class provides the following methods:
string GenerateDnsRecord(int length = 10)
Generates a domain name verification code that users can add as TXT or CNAME records to prove ownership.
string verificationCode = _dnsRecordsGenerator.GenerateDnsRecord(15);
string GetTxtInstructions(string domainName, string verificationCode, TxtRecordSettings? options = null)
This method provides users with instructions on adding the TXT record to their DNS for domain verification.
The TxtRecordSettings
is a configuration class that includes the Hostname
(representing the name of the TXT record) and RecordAttribute
(optional content attribute of the TXT record). This configuration class is optional if the DnsRecordsGenerator
has already been instantiated with the DomainVerifierSettings
.
const string domainNameToVerify = "the-domain-to-verify.com";
const string verificationCode = "randomcode"; // generated using GenerateDnsRecord()
var config = new TxtRecordSettings
{
Hostname = "@", // or anything else but unique. example: _myappname-challenge-code
RecordAttribute = "my-appname-verification" // optional
};
string instructions = _dnsRecordsGenerator.GetTxtInstructions(domainNameToVerify, verificationCode, config)
The verification code needs to be stored in the database alongside the corresponding domain name. Regarding configuration, placing it in the
appsettings.json
file is a straightforward option. However, it is crucial to ensure that the verification code remains constant as long as there are unverified domains stored in the database.
string GetCnameInstructions(string verificationCode, CnameRecordSettings? options = null)
This method serves the same purpose as the previous one but for CNAME records.
It provides users with instructions for adding the CNAME record to their DNS settings.
The CnameRecordSettings
is a configuration class that includes the RecordTarget
(representing the target of the CNAME record). This configuration class is also optional if the DnsRecordsGenerator
has been instantiated with the DomainVerifierSettings
.
const string domainNameToVerify = "the-domain-to-verify.com";
const string verificationCode = "randomcode"; // generated using GenerateDnsRecord()
var config = new CnameRecordSettings("verify.myappname.com");
string instructions = _dnsRecordsGenerator.GetCnameInstructions(domainNameToVerify, verificationCode, config)
🔍DnsRecordsVerifier
The DnsRecordsVerifier
class is a service designed to validate whether verification codes are configured in the DNS settings of a given domain name, thereby proving ownership.
It has two methods: IsTxtRecordValidAsync
and IsCnameRecordValidAsync
, which return true or false depending on whether the ownership is verified.
async Task<bool> IsTxtRecordValidAsync(string domainName, string verificationCode, TxtRecordSettings? options = null)
Asynchronously checks if the TXT record is valid for the specified domain and verification code.
const string domainName = "the-domain-to-verify.com"; // retrieved from database
const string verificationCode = "randomcode"; // retrieved from database
var config = new TxtRecordSettings
{
Hostname = "@", // Load from configurations
RecordAttribute = "my-appname-verification" // Load from configurations
};
var isOwnershipVerified = await _dnsRecordsVerifier.IsTxtRecordValidAsync(domainName, verificationCode, config);
// Update your database to mark the domain as verified
async Task<bool> IsCnameRecordValidAsync(string domainName, string verificationCode, CnameRecordSettings? options = null)
Asynchronously checks if the CNAME record is valid for the specified domain and verification code.
const string domainName = "the-domain-to-verify.com"; // retrieved from database
const string verificationCode = "randomcode"; // retrieved from database
var config = new CnameRecordSettings
{
RecordTarget = "verify.myappname.com", // Load from configurations
};
var isOwnershipVerified = await _dnsRecordsVerifier.IsCnameRecordValidAsync(domainName, verificationCode, config);
// Update your database to mark the domain as verified
🌟 Best Practices
- Optimize the verification process by executing it in the background using .NET hosted services or background services. Additionally, provide an endpoint that users can use to trigger the verification process.
- In scenarios where multiple users attempt to claim ownership of a specific domain, generate a unique verification code for each user. The rightful owner will be able to prove ownership using the respective code.
DomainVerifier.Extensions (the recommended way)
DomainVerifier.Extensions
project provides integration with Dependency Injection
You can use it by invoking the AddDomainVerifierService
extension method on IServiceCollection
. The configuration builder wraps various configuration properties with strongly-typed API. You can also configure properties using standard .NET appsettings.json
inside the configuration section name DomainVerifierSettings
.
Instructions
Step 1: Install the DomainVerifier.Extensions
NuGet package in your application.
dotnet add package DomainVerifier.Extensions
Step 2: Add the verification configuration to your appsettings.json
:
{
"DomainVerifierSettings": {
"DnsServers": [ // Optional
{
"Name": "My Custom DNS Server Name", // Optional
"IpAddress": "127.0.0.1",
"Port": 53
}
],
"TxtRecordSettings": {
"Hostname": "@",
"RecordAttribute": "my-appname-verification"
},
"CnameRecordSettings": {
"RecordTarget": "verify.myappname.com"
}
}
}
Step 3: Add the Domain verifier service to the service collection:
services.AddDomainVerifierService(configuration);
DnsRecordsGenerator
and DnsRecordsVerifier
are already registered with the dependency injection containers.
Usage:
Simply inject the IDnsRecordsGenerator
or IDnsRecordsVerifier
interface into your service class or controller.
Explore the example project available in the examples folder. This project is built on .NET 8 minimal Api and featuring the following technology stack:
- Database support (Sqlite)
- Vertical slice architecture
- Quartz for job scheduling
- The new Identity API endpoints
The sample project provides a range of endpoints, offering a comprehensive demonstration of the implementation. Refer to the following screenshot for a visual overview of these endpoints.
In addition to the showcased endpoints, the example project includes the source code for the Quartz background job responsible for processing ownership verification every 5 minutes.
[DisallowConcurrentExecution]
public class ProcessVerificationJob : IJob
{
private readonly ApplicationDbContext _dbContext;
// 👇 Inject the IDnsRecordsVerifier interface from DomainVerifier.Extensions
private readonly IDnsRecordsVerifier _dnsRecordsVerifier;
public ProcessVerificationJob(
ApplicationDbContext dbContext,
IDnsRecordsVerifier dnsRecordsVerifier)
{
_dbContext = dbContext;
_dnsRecordsVerifier = dnsRecordsVerifier;
}
public async Task Execute(IJobExecutionContext context)
{
var unVerifiedDomains = await _dbContext.Domains
.Where(x => !x.IsVerified && !_dbContext.Domains
.Any(y => y.IsVerified && y.DomainName == x.DomainName))
.OrderBy(x => x.VerificationDate)
.Take(20)
.ToListAsync(context.CancellationToken);
foreach (var domain in unVerifiedDomains)
{
domain.VerificationDate = DateTime.UtcNow;
// 👇 Verification
var isVerificationSucceeded =
await _dnsRecordsVerifier.IsTxtRecordValidAsync(domain.DomainName, domain.VerificationCode)
|| await _dnsRecordsVerifier.IsCnameRecordValidAsync(domain.DomainName, domain.VerificationCode);
if (isVerificationSucceeded)
{
domain.IsVerified = true;
domain.VerificationCompletedDate = DateTime.UtcNow;
}
}
_dbContext.UpdateRange(unVerifiedDomains);
await _dbContext.SaveChangesAsync(context.CancellationToken);
}
}
Feel free to adapt and integrate it into your own project.
Contributing
Contributions to domainverifier-dotnet
are very welcome. For guidance, please see CONTRIBUTING.md
Created by: Laurent Egbakou
- Twitter: @lioncoding
- LinkedIn: Laurent Egbakou
Frequently Asked Questions
Q: I am using .NET Core 3 - .NET 5 web API or web app. How do I use this library?
A: Refer to the AddDomainVerifierService(configuration) method and replicate it in your target framework.
Q: Can I use this library in my commercial project?
A: Yes.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- DomainVerifier (>= 1.0.0)
-
net7.0
- DomainVerifier (>= 1.0.0)
-
net8.0
- DomainVerifier (>= 1.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.0 | 214 | 1/1/2024 |
See https://github.com/egbakou/domainverifier-dotnet/releases for release notes.