domain_configuration
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
domain_configuration [2019/03/05 15:23] – lucy | domain_configuration [2022/01/17 20:04] (current) – lucy | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ==== Introduction ==== | + | ======= Introduction |
- | LUCY works with virtualized servers. That’s why you can run multiple campaigns with different domain names in parallel on the same IP. There is no limitations on the number of domains you can map to LUCY. When you buy our [[advantage_of_using_our_vps|VPS option]] you already have 1 domain included. You can add more domains to the VPS yourself using the registration wizard in LUCY or ask us configuring | + | LUCY works with virtualized servers. That’s why you can run multiple campaigns with different domain names in parallel on the same IP. There are no limitations on the number of domains you can map to LUCY. When you buy our [[advantage_of_using_our_vps|VPS option]] you already have 1 domain included. You can add more domains to the VPS yourself using the registration wizard in LUCY or ask us to configure |
- | If you define a domain in LUCY's web GUI, it can only be used for the phishing campaign – not the Admin access. By default the administrative access works only with an IP address; however LUCY’s administrative access can still be reached using a domain name in the browser. This works only if you have defined [[setup_script_tutorial|Domain Name in the Initial Setup Script]]. Please note that this can be done only if you choose the Manual Setup instead of the Automatic Setup. It is also only possible to map 1 domain for the administration UI. | + | If you define a domain in LUCY's web GUI, it can only be used for the phishing campaign – not the Admin access. By default the administrative access works only with an IP address; however, LUCY’s administrative access can still be reached using a domain name in the browser. This works only if you have defined [[setup_script_tutorial|Domain Name in the Initial Setup Script]]. Please note that this can be done only if you choose the Manual Setup instead of the Automatic Setup. It is also only possible to map 1 domain for the administration UI. |
Line 12: | Line 12: | ||
{{ 10.jpg? | {{ 10.jpg? | ||
- | LUCY will generate the according certificate for that domain and you will be able to access LUCY using this domain name. If you want to create a trusted certificate for this domain you can go to the [[ssl_configuration|ssl settings]] menu and choose "Lets Encrypt" | + | LUCY will generate the according certificate for that domain and you will be able to access LUCY using this domain name. If you want to create a trusted certificate for this domain you can go to the [[ssl_configuration|ssl settings]] menu and choose "**Lets Encrypt" |
{{ adminssl.png? | {{ adminssl.png? | ||
Line 36: | Line 36: | ||
**Use the Private IP from LUCY** | **Use the Private IP from LUCY** | ||
- | If LUCY is located on a private network, you have to select the option " | + | If LUCY is located on a private network, you have to select the option |
\\ | \\ | ||
{{ 26.jpg? | {{ 26.jpg? | ||
Line 46: | Line 46: | ||
This option allows you to run LUCY in a private network (e.g. on your laptop) and make it accessible from the internet (assuming your firewall allows port forwarding rules for a specific host). Service like DynDNS will allow you to run LUCY on a private IP behind a NAT Device. The Dynamic DNS account information can be saved in Settings/ | This option allows you to run LUCY in a private network (e.g. on your laptop) and make it accessible from the internet (assuming your firewall allows port forwarding rules for a specific host). Service like DynDNS will allow you to run LUCY on a private IP behind a NAT Device. The Dynamic DNS account information can be saved in Settings/ | ||
\\ | \\ | ||
- | First define the Dynamic Domain in " | + | First, define the Dynamic Domain in **" |
{{ 29.jpg? | {{ 29.jpg? | ||
\\ | \\ | ||
Line 57: | Line 57: | ||
==== Use a Public Domain for LUCY ==== | ==== Use a Public Domain for LUCY ==== | ||
- | - **Option 1: You don't have a domain yet**: If you don't have a domain registered yet, you can use the integrated LUCY Domain Registration Wizard. This feature is only available for commercial licenses, allowing you to reserve all the available domain names for an affordable price. Commercial clients have a built in budget for using the domain API and are also able to later add credits for the domain reservation. | + | - **Option 1: You don't have a domain yet**: If you don't have a domain registered yet, you can use the integrated LUCY //Domain Registration Wizard//. This feature is only available for commercial licenses, allowing you to reserve all the available domain names for an affordable price. Commercial clients have a built-in budget for using the domain API and are also able to later add credits for the domain reservation. |
- | - **Option 2: You already have a domain**: In order to use a Public Domain you need to add the domain in the settings menu " | + | - **Option 2: You already have a domain**: In order to use a Public Domain you need to add the domain in the settings menu **" |
{{ 1.png?600 }} | {{ 1.png?600 }} | ||
- | **Note:** If you defined a domain within the Settings like example.com, | + | **Note:** If you defined a domain within the Settings like example.com, |
{{ 2.png?600 }} | {{ 2.png?600 }} | ||
Line 73: | Line 73: | ||
- | LUCY allows you to allocate specific subdomains for a given Domain Name. Let's assume you have registered the domain " | + | LUCY allows you to allocate specific subdomains for a given Domain Name. Let's assume you have registered the domain " |
{{ dnsa.png? | {{ dnsa.png? | ||
Line 81: | Line 81: | ||
{{ sdns.png? | {{ sdns.png? | ||
- | ****Please note:**** you can host campaigns with multiple subdomains using the same domain name in different campaigns within LUCY (e.g. domain1.example.com & domain2.example.com). In order to map multiple a-records to LUCY you need to create the according DNS record (usually providers offer you to save a wildcard DNS A-record like *.yourdomain.com which allows you to use any subdomain you want). If you registered the domain through LUCY's API, then we have automatically created such a wildcard subdomain record for you and it will work immediately. | + | **Please note:** you can host campaigns with multiple subdomains using the same domain name in different campaigns within LUCY (e.g. domain1.example.com & domain2.example.com). In order to map multiple a-records to LUCY you need to create the according DNS record (usually providers offer you to save a wildcard DNS A-record like *.yourdomain.com which allows you to use any subdomain you want). If you registered the domain through LUCY's API, then we have automatically created such a wildcard subdomain record for you and it will work immediately. |
- | ===== Register a New Domain through LUCY ===== | + | ====== Register a New Domain through LUCY ====== |
+ | |||
+ | ====Introduction==== | ||
- | **Introduction: | ||
LUCY offers a Domain Registration Wizard (either within a campaign or by accessing the DNS settings). Most commercial licenses come with a 20 $ deposit which usually will allow you to reserve 1-3 domains. You can see your current balance within the license (under settings/ | LUCY offers a Domain Registration Wizard (either within a campaign or by accessing the DNS settings). Most commercial licenses come with a 20 $ deposit which usually will allow you to reserve 1-3 domains. You can see your current balance within the license (under settings/ | ||
**How to reserve your domain** | **How to reserve your domain** | ||
- | You can look for specific domain names and buy them using the Domain Wizard. LUCY will automatically create a DNS record for your domain and register LUCY's Public IP for the domain. We also automatically reserve a wildcard domain. So if you would reserve a domain like " | + | You can look for specific domain names and buy them using the Domain Wizard. LUCY will automatically create a DNS record for your domain and register LUCY's Public IP for the domain. We also automatically reserve a wildcard domain. So if you would reserve a domain like " |
+ | **Make sure you leave a valid e-mail address within the domain reservation form**.\\ | ||
+ | Our provider will send you a confirmation mail with access | ||
+ | |||
+ | {{ dom_reg_email.png?600 }} | ||
- | **Can all domains be reserved through LUCY?** | ||
- | No. Some domains, especially those with a country code (like .us, .fr etc) require additional information (e.g. proof of residence) which cannot be provided through the API. Domain names that contain typosquatted versions known brands (like dropbox, amazon etc.) will also cause problem as those brands are actively monitored. | ||
**How long does it take before the domain can be used in a campaign?** | **How long does it take before the domain can be used in a campaign?** | ||
- | When you make a DNS change, it takes time for the changes to take effect. This is called DNS propagation. It is the time it takes for the domain DNS to refresh the cache on the network. DNS will refresh according to the " | + | When you make a DNS change, it takes time for the changes to take effect. This is called DNS propagation. It is the time it takes for the domain DNS to refresh the cache on the network. DNS will refresh according to the " |
- | **Will my registration information be available to anyone | + | **Will my registration information be available to anyone |
Your info from the registration form will not appear within the WHOIS database as we automatically add the WHOIS protection package to your order (free of charge). | Your info from the registration form will not appear within the WHOIS database as we automatically add the WHOIS protection package to your order (free of charge). | ||
+ | |||
+ | **Are domains auto-renewed? | ||
+ | Domains are only purchased for one year. They do not auto-renew | ||
**How can the domains be renewed?** | **How can the domains be renewed?** | ||
You will get a notification on the LUCY dashboard before a domain expires. Additionally, | You will get a notification on the LUCY dashboard before a domain expires. Additionally, | ||
+ | |||
+ | **How can I terminate a domain?** | ||
+ | Domains are terminated automatically after a year. If you don't want the domain to work anymore, you can delete the according DNS records within the domain admin panel yourself. | ||
**Will you be able to manually take control over the DNS settings/ | **Will you be able to manually take control over the DNS settings/ | ||
- | No. The API will create all the necessary DNS settings (SPF, wildcard a-record, MX record etc.) so there will be no need to do any DNS settings yourself. But if you still need to take control over the domain purchased through LUCY, you can contact us and we will transfer | + | The API will create all the necessary DNS settings (SPF, wildcard a-record, MX record, etc.) so there will be no need to do any DNS settings yourself. But if you still need to take control over the domain purchased through LUCY, you can edit the DNS entries by accessing the domain portal (provided during the initial domain registration) or by contacting the LUCY Support team. |
- | **I see an error message "error creating domain" | + | **I see an error message "Error creating domain" |
- | This error appears if our DNS provider is not accepting the registration. There are many reasons for such an error (temporary network issue on the providers | + | This error appears if our DNS provider is not accepting the registration. There are many reasons for such an error (temporary network issue on the provider' |
* You can re-try a few minutes later. | * You can re-try a few minutes later. | ||
Line 124: | Line 133: | ||
- | Note: you can always create an e-mail forwarding account. | + | **Note**: you can always create an e-mail forwarding account. |
{{ mail_forward.png? | {{ mail_forward.png? | ||
Line 130: | Line 139: | ||
- | ===== Register a New Domain through your provider ===== | + | ====== Register a New Domain through your provider ====== |
+ | ===== Add your domain to Lucy ===== | ||
+ | |||
+ | |||
+ | You can register the desired domain with your own provider and point the DNS records to LUCY. Simply go to **Settings -> Domain**. Then click **" | ||
+ | |||
+ | |||
+ | {{ domain_setup-own.png? | ||
+ | |||
+ | |||
+ | ===== Create the DNS records that point to Lucy ===== | ||
+ | You should create the following DNS records (the name of the fields may vary from provider to provider. Please check the online documentation of your provider to learn how to set those DNS records): | ||
- | You can register the desired domain with your own provider and point the DNS records to LUCY. You should create the following DNS records (the name of the fields may vary from provider to provider. Please check the online documentation of your provider to learn how to set those DNS records): | + | {{ dns_records.png?600 }} |
- | - Create a **wildcard subdomain record**: this record will allow you to use any type of subdomain in LUCY (e.g. www.yourdomain.com, | + | - Create a **wildcard subdomain record**: this record will allow you to use any type of subdomain in LUCY (e.g. www.yourdomain.com, |
- | - Optional: | + | - Create an A-record with a host/name field set to **" |
- | - Optional: create s SPF record. In your domain administration panel click " | + | - Create **two** |
- | - Optional: create a MX record by selecting "create custom MX" | + | - Create an MX record by selecting |
domain_configuration.1551795790.txt.gz · Last modified: 2019/07/25 12:50 (external edit)