Versions Compared

Old Version 3

changes.mady.by.user Jose Luis Lozano

Saved on

compared with

New Version 4

changes.mady.by.user Jose Luis Lozano

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleHow to set up a Forwarding Domain?

How to set up a Forwarding Domain?

A verified forwarding domain allows you to send EviMails with an email account from that domain with the security of delivery as the SPF and DKIM settings are verified.

To set up a forwarding domain, it must be registered on your site with an Administrator user. Only Site Administrators will be able to register domains. 

The registration and configuration of domains is done from the "Management of forwarding domainssender e-mail addresses" screen, which can be accessed from the top menu "My Data".

Image Added

Grid of forwarding domains

This screen shows the domains that have been configured on a given site. These domains appear in a Grid divided into 7 columns

  1. State : State in which the domain is located
    1. Verified: The domain has been verified by the system.
    2. Not verified: The domain could not be verified by the system.
  2. Domain: This is the name of the domain that has been configured.
  3. Description: Brief description of the domain.
  4. Creation date: Date on which the domain was created.
  5. Details button: Allows you to view the details of the domain configuration and manually perform a verification.
  6. Edit button: Allows you to make changes to the domain configuration.
  7. Remove button: Allows you to remove the configuration of a domain on a given site.

Registration of a referral domain

By clicking on the "Add domain" button, a modal screen is displayed to start the configuration of a new domain.

In this first step, the user is reminded that he/she must have access to the DNS settings of the domain he/she intends to configure, and the recommendation to use subdomains.


Verifying the domain

This is the next step in the domain registration process. In this step the user is shown the necessary configurations that must be made in the DNS of his domain so that it can be verified.

These configurations are customised with the domain entered in the previous step. To make it easier for the user to enter data into their systems.

Once the user has made the necessary modifications to the DNS file of his domain, he has the option to verify the domain by clicking on the "Verify domain" button or Exit the process by clicking on "Cancel".

The user is also given the option to create his own DKIM selector for that domain, by clicking on the button "Add custom key" a popup window will open to generate the selector and the pair of keys (private and public) this option will be detailed further on.

SPF configuration

The SPF record of the client's domain server must contain the mention of our server _spf.evicertia.com, for example as follows:

Code Block
example.com text = “v=spf1 mx ip4:130.21.85.0/24 ip4:200.140.104.10/22 include:_spf.evicertia.com ~all”

DKIM configuration

The DKIM record must contain one of the following settings. Depending on whether you have set your own selector or the two Evicertia shared selectors.

  1. Default Selectors: from Evicertia

    The DNS must have two CNAME entries configured with the default Evicertia.com selectors.

    Selector

    registro

    Valor

    herma-a

    herma-a._domainkey.<dominio_configurado>

    CNAME:herma-a._domainkey.evicertia.com.

    herma-b

    herma-b._domainkey.<dominio_configurado>

    CNAME:herma-b._domainkey.evicertia.com.


    Code Block
    titleExample with domain "acmedomain.com""
    herma._domainkey.acmedomain.com: CNAME: CNAME:herma._domainkey.evicertia.com.
herma2._domainkey.acmedomain.com: CNAME: CNAME:herma2._domainkey.evicertia.com.


  2. Custom selector (Custom key):

    Users can create their own DKIM selectors associated with the domain

    Selector DKIM

    registro

    k (Key type)

    p  (Public key)

    Nombre del selector 

    <selector_configurado>._domainkey.<dominio_configurado>

    rsa

    Clave pública generada al crear el selector y añadirlo al dominio


    Code Block
    titleExample with domain "acmedomain.com" and selector "acmeselector""
    acmeselector._domainkey.acmedomain.com: TXT: "v=DKIM1; k=rsa;p=XVVVCSsdss45DSADAUAA4GNADCBiQKBgQDBcTgrPyLzZThYDTcuguHXPNBe+NaZqPqfnwKhNEAmfMdF4FmHByeFeqkWkxQ5zhbiui0iyxiDE7DsW/V2SgOampuwy8pnmkcZaF1UU0a/Dg/GUYip+EB2sPkdTgdBq7gDPSSY6MnoFeOVunLYyYVZaPs+AfF4g6iuxJfdfdfsferB"


...

Expand
titleHow to use a sender email account from my website.?

From the New EviMail screen. The FROM section appears first, from which you can now configure the sender. 

In the "Email to use as sender" field, the user may select any of the email addresses configured. Also by clicking on the icon Image Added you can edit the text that is displayed as the sender in the e-mail that is sent.

Image Added

Como usar una cuenta de remite desde mi sitio web.


Expand
titleHow to use a sender email account from API.?

In the call to EviMailSubmit a new text parameter FROM is added, this parameter is optional, if not specified the default email account will be used.


From (text) Opcional : E-mail address with which the FROM of the EviMail e-mail will be configured. The submit will validate that the address is configured in the sending user's account and that the domain is verified. 

Code Block
languagetext
titleAPI
POST /api/EviMail/Submit HTTP/1.1
Host: app.evicertia.com
Authorization: Basic xxxxx9jZWJlcg==
Content-Type: application/json 
 
{
    "LookupKey": "234234",
    "Subject": "this is the subject of the email",
    "Body": "This is the Body of the email",
    "From":"user01@newcompany.com",
    "Recipient": {
        "LegalName": "LegalName",
        "EmailAddress": "recipient@testmail.com"
    },
    "Options": {
        "AffidavitKinds": [
            "DeliveryResult"
        ],
        "CertificationLevel": "Advanced",
        "TimeToLive": 365,
        "HideBanners": true,
        "NotaryRetentionPeriod": 0,
        "OnlineRetentionPeriod": 1
    }
}
Como usar una cuenta de remite desde API