Skip to content
This repository was archived by the owner on Jun 30, 2025. It is now read-only.

Commit a3bc1cc

Browse files
✨ Add Guidance For Assessing Existing Domain Names (#256)
1 parent 8606d37 commit a3bc1cc

File tree

1 file changed

+36
-11
lines changed

1 file changed

+36
-11
lines changed

source/documentation/services/domain-naming-standard.html.md.erb

Lines changed: 36 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Please refer to [How to get, register or manage a domain name]
2121
### `service.gov.uk`
2222

2323
The [GOV.UK service manual]
24-
(https://www.gov.uk/service-manual/technology/get-a-domain-name) sets out when
24+
(<https://www.gov.uk/service-manual/technology/get-a-domain-name>) sets out when
2525
and how to get a `*.service.gov.uk` subdomain.
2626

2727
In short, `*.service.gov.uk` subdomains are for public-facing services which
@@ -40,7 +40,7 @@ This includes:
4040
However, cloud-hosted software-as-a-service used by MOJ staff (like Google
4141
Workspace or Microsoft365), or on which MOJ has a corporate presence (like
4242
[GitHub](https://github.com/ministryofjustice) or [Trello]
43-
(https://trello.com/mojds/home)) are not required to be served from a
43+
(<https://trello.com/mojds/home>)) are not required to be served from a
4444
`*.service.justice.gov.uk` subdomain.
4545

4646
#### Cloud Platform and Modernisation Platform
@@ -85,7 +85,7 @@ This pattern makes the relationships between domains clear, grouping
8585
environments by service and applications by shared environment.
8686

8787
Non-production environments and [hosted prototypes]
88-
(https://www.gov.uk/service-manual/design/making-prototypes#sharing-code-prototypes)
88+
(<https://www.gov.uk/service-manual/design/making-prototypes#sharing-code-prototypes>)
8989
should also use authentication (such as HTTP basic auth) to prevent public
9090
users who come across them thinking they’re real.
9191

@@ -94,7 +94,7 @@ clear to users which environment they’re in - but that’s more useful for peo
9494
working on the service to not modify data in production than to keep users out.
9595
GOV.UK publishing apps do this, for example compare GOV.UK Signon in their
9696
[Staging](https://signon.staging.publishing.service.gov.uk) and [Production]
97-
(https://signon.publishing.service.gov.uk) environments.
97+
(<https://signon.publishing.service.gov.uk>) environments.
9898

9999
## Welsh language versions of sites and domain naming
100100

@@ -124,13 +124,13 @@ You should use a `.gov.uk` subdomain, as above, for these reasons:
124124
is not renewed, it can be bought by a squatter and used for phishing and
125125
scams
126126
- The Service Manual says [not to use the crown, New Transport font etc]
127-
(https://www.gov.uk/service-manual/design/making-your-service-look-like-govuk#if-your-service-isnt-on-govuk)
127+
(<https://www.gov.uk/service-manual/design/making-your-service-look-like-govuk#if-your-service-isnt-on-govuk>)
128128
if your service isn't on a `gov.uk` domain
129129
- Unfamiliar domains look untrustworthy, putting off users including internal
130130
staff from using the service
131131
- Normalizing the use of unfamiliar domains increases the risk of phishing
132132
- NCSC's [Takedown Service]
133-
(https://www.ncsc.gov.uk/information/takedown-service) will likely take down
133+
(<https://www.ncsc.gov.uk/information/takedown-service>) will likely take down
134134
the site if you're using GOV.UK Design System, the crown, New Transport font
135135
etc; and it's not on a .gov.uk domain
136136
- Google's anti-phishing protection could at any time flag a site as 'deceptive'
@@ -144,17 +144,17 @@ You should use a `.gov.uk` subdomain, as above, for these reasons:
144144
### Exemptions (where you can use a non-`gov.uk` domain)
145145

146146
The [GOV.UK Proposition]
147-
(https://www.gov.uk/government/publications/govuk-proposition/govuk-proposition)
147+
(<https://www.gov.uk/government/publications/govuk-proposition/govuk-proposition>)
148148
sets out an exemption criteria to use a non-`gov.uk` domain.
149149

150150
If your service falls into [What does not go on GOV.UK]
151-
(https://www.gov.uk/government/publications/govuk-proposition/govuk-proposition#what-does-not-go-on-govuk):
151+
(<https://www.gov.uk/government/publications/govuk-proposition/govuk-proposition#what-does-not-go-on-govuk>):
152152

153153
- follow the [GOV.UK exemptions]
154-
(https://www.gov.uk/government/publications/govuk-proposition/govuk-proposition#govuk-exemptions)
154+
(<https://www.gov.uk/government/publications/govuk-proposition/govuk-proposition#govuk-exemptions>)
155155
guidance
156156
- [request an exemption]
157-
(https://www.gov.uk/guidance/content-design/planning-content#getting-an-exemption)
157+
(<https://www.gov.uk/guidance/content-design/planning-content#getting-an-exemption>)
158158
from GOV.UK
159159
- once approved, forward the approval to the [Operations Engineering team]
160160
(mailto:domains@digital.justice.gov.uk)
@@ -164,4 +164,29 @@ The Operations Engineering team will then:
164164
- work with you to register your domain
165165
- manage renewals for the domain
166166
- set up the domain to adhere to the [MOJ's Security Guidance]
167-
(https://security-guidance.service.justice.gov.uk/#cyber-and-technical-security-guidance)
167+
(<https://security-guidance.service.justice.gov.uk/#cyber-and-technical-security-guidance>)
168+
169+
## Assessing Existing Domains
170+
171+
If you already have a domain that you are using to provide Ministry of Justice Services, you can follow these steps assess the domain's compliance with our standards:
172+
173+
- ✅ If the domain name ends with `gov.uk`, it is compliant with our standards. All domains with this Top Level Domain will have gone through the relevant checks and approvals before being created.
174+
- ✅ If the domain name does not end with `gov.uk`, [check if the domain is owned by the Ministry of Justice](#check-if-a-domain-is-owned-by-the-ministry-of-justice). After, [check if the domain is deprecated](#check-if-a-domain-is-deprecated). If the domain is owned by the Ministry of Justice and is not deprecated, then it is probably compliant with our standards. It still may be worth considering migrating the service to the `gov.uk` domain where appropriate - but this is not a requirement in all cases.
175+
176+
### Check if a Domain is Owned by The Ministry of Justice
177+
178+
You can check if the domain is owned by the Ministry of Justice by looking up the domain name in our public [DNS Repository](https://github.com/ministryofjustice/dns/blob/main/hostedzones). If the Second Level Domain is owned by the Ministry of Justice, in most cases there will be Hosted Zone file for the domain in the repository.
179+
180+
> *Example*: If you have a domain called `testing.example.com`, you can look up the domain in the [DNS Repository](https://github.com/ministryofjustice/dns/blob/main/hostedzones) to see if there is a Hosted Zone file for `example.com` which should be called `example.com.yaml`.
181+
182+
If there is not a Hosted Zone file for the domain, the domain may still be owned by the Ministry of Justice. To verify if the domain is owned by the Ministry of Justice, contact the [Operations Engineering Team](mailto:domains@digital.justice.gov.uk) to confirm.
183+
184+
***‼️ If you are providing Ministry of Justice Services on a domain that is not owned by the Ministry of Justice, please contact the [Operations Engineering Team](mailto:domains@digital.justice.gov.uk) to discuss transferring the domain to the Ministry of Justice.***
185+
186+
### Check if a Domain is Deprecated
187+
188+
Deprecated domains may still serve Ministry of Justice Services, but we will no longer accept new requests to provision new services on the domain. If you run Ministry of Justice Services on a domain that is deprecated, you should consider migrating the service to a `gov.uk` domain.
189+
190+
Below is a list of deprecated domains:
191+
192+
- `dsd.io`

0 commit comments

Comments
 (0)