Custom implementation
      Back to home
      1. Support
      2. Getting started
      3. Custom implementation

      How to Activate the Custom Sender Email Address

      As per the default configuration, Tokeny automatically sends the authentication emails from app@onchainid.com and the transactional emails from app@tokeny.com or noreply@tokeny.com.

      Although the sender of the authentication emails cannot be updated as those are directly associated with the investor’s ONCHAINID, the custom sender email address of the transactional email templates can be easily configured, following the steps outlined below:

      New Sender Activation:

      1. As part of the go-live procedure, you’ll need to share the following inputs with your Customer Success Manager (CSM):

        1. Email Address: An already existing email address that you wish to use as a sender email address and to which you and/or your team have access
        2. Technical Email Contact:  An email address from a representative from the technical side of the business on your team. This person needs to have access to the DNS zone of your domain and have a basic knowledge on how to make alterations to it, as the creation of the new domain records will be required

      2. After your CSM has completed the initial configuration of Mailjet (the email delivery system used by Tokeny), you will receive the following email from Mailjet to the email address you provided:

        1-May-25-2023-01-17-02-2392-PM

      3. Please now forward the email to your CSM, who will then validate the activation of your sender email address by clicking on the activation link

      Domain Authentication Setup:

      For optimal deliverability and improved sender reputation of the emails, we will proceed with the update of the authentication settings by setting up the SPF and DKIM records.

      An SPF record (Sender Policy Framework) lists all servers that are allowed to send emails from your domain while the DKIM record contains a public key, used by receivers to check that the email actually comes from an authorized sender.

      To set up the SPF & DKIM authentication for your domain, you will need to access your DNS records in your domain hosting account (GoDaddy, 1&1, HostGator, OVH, ….). If you cannot locate or do not have access to your DNS records, please contact your domain hosting provider for assistance.

      In summary, to authenticate your domain, you will need to copy the SPF & DKIM values you’ll receive from your CSM to set up SPF & DKIM DNS records in your hosting account.

      The SPF Record Setup:

      1. Log into your hosting account or where your DNS records can be accessed
      2. Head to the section where you can manage your DNS records
      3. If you don't  see an SPF record, you will need to create a new record; otherwise, you will edit the existing SPF record (There is only one SPF record per domain). If you have more than one SPF DNS record, ISPs will not be able to differentiate which one to use, which can cause authentication issues).

        1. Add a new DNS record of type TXT

          1. Copy the host name from the configuration your CSM shared with you to the 'Host' field

          2. Copy the SPF value from the configuration your CSM shared with you to the 'TXT Value' field. (Some providers may require double quotes around the value field. It is best to contact your provider for assistance if you are unsure).

          3. Save the record

          2-May-25-2023-01-17-58-1051-PM

        1. Edit an already existing SPF Record

          1. In the case you already have an SPF record, simply add the “include” part of your SPF value to the SPF’s 'TXT Value' field

          2. Save your changes

      3-May-25-2023-01-19-36-9718-PM

      DKIM Record Setup:

      To setup DKIM authentication, you will be creating a new DKIM record. (Unlike SPF records, there are no issues with having multiple DKIM DNS records in your domain).

      1. Log into your hosting account or where your DNS records can be accessed
      2. Head to the section where you normally manage your DNS records
      3. Create a new DNS record of type TXT

        1. In the 'Host' field, add the value mailjet._domainkey.yourdomain.com. and replace yourdomain with the domain name you are authenticating).

          4-May-25-2023-01-20-20-9654-PM

        2. The second step is to copy the very long DKIM value into the 'TXT Value' field

          5-May-25-2023-01-20-48-7363-PM

        3. Save the record

      Please note that some domain providers may require double quotes " " around the entire 'TXT Value'. (If you are unsure whether to add the quotes, please contact your provider’s support team for clarification).

      In addition, some providers will automatically add the domain name to the end of the text value in the 'Host' field. Please double check the text in the 'Host' field after you saved the record.

      The last step is to inform your Customer Success Manager that you’ve configured the records. Keep in mind that the changes will not go into effect immediately and can take up to 24 to 48 hours to propagate across the internet. Your CSM will notify you if anything is missing or if any alterations are required.

      Thank you,

      Tokeny :tokeny:

       

      For additional assistance, please see the following sources on how to edit DNS records for: