Purpose:

This section is explain how to set up First-party cookie. 

Note: 

1. It is recommended to configure first-party cookies before setting up the subdomain.
2. If the subdomain is set up before first-party cookies are configured, the Booking Widget may be blocked by a popup blocker.
   

1. Where to Set

1. Setting page: Brand Management Screen
   
2. Action: 'Admin Setting' → [First Party Cookie Settings]

The First-part cookie setting screen will be open.

---

2. Register First Party Cookie Subdomain URL

1. Register the subdomain URL that will be used to issue the first-party cookie.
2. The subdomain must use the same root domain as the website’s main homepage.
   
3. The same URL cannot be used for both “Subdomain URL Registration” and “First Party Cookie URL Registration”.
4. ▼Example: If the homepage domain is “tripla-hotel.com”, an acceptable subdomain would be “api.tripla-hotel.com”.
   

---

3. Set up SSL Certificate

3.1 I have a SSL Certificate

Step 1	Select [I have a SSL Certificate].
Step 2	Enter the following items. ・ SSL Certificate Body ・ SSL Certificate Private Key ・ SSL Certificate Chain
Step 3	By clicking [Save] button, the status displayed at the top of the screen will change.

▼The status name and explanation will be as below:

Status	Explanation
1. Initialized	No settings have been configured yet.
2. SSL Certificate Issuing DNS Validation	The DNS verification for issuing the SSL certificate is currently in progress.
3. SSL Certificate Pending Validation	The SSL certificate configuration is currently being verified.
4. Load Balancer Pending Validation	The load balancer configuration is currently being verified.
5. Completed	・The verification has been completed. ・Once verification is complete, the [Test] option becomes unavailable. ・Click [Test] to check the current progress.

How to Convert an SSL certificate to PEM format

1. The command below converts an SSL certificate file to PEM format.
2. Replace <subdomain> with the URL used for the first-party cookie, then run the command.

1. openssl x509 -in sv-<subdomain>.cer.full -out certificate.pem -outform PEM
   openssl rsa -in sv-<subdomain>.key.np -out private.pem
   

3.2  I don't have a SSL Certificate

Step 1	Select [I don't have a SSL Certificate].
Step 2	By clicking [Save] button, the status displayed at the top of the screen will change.

▼The status name and explanation will be as below:

Status	Explanation
1. Initialized	No settings have been configured yet.
2. SSL Certificate Issuing DNS Validation	The DNS verification for issuing the SSL certificate is currently in progress.
3. SSL Certificate Pending Validation	The SSL certificate configuration is currently being verified.
4. Load Balancer Pending Validation	The load balancer configuration is currently being verified.
5. Completed	・The verification has been completed. ・Once verification is complete, the [Test] option becomes unavailable. ・Click [Test] to check the current progress.

To proceed with verification, please update the CNAME record in your DNS provider.

Once the subdomain URL is registered and the SSL certificate option ([I have a SSL Certificate] or [I don’t have a SSL Certificate]) is selected and saved, the subdomain URL cannot be changed afterward.

4. Register CNAME Record for Authentication

1. This verification CNAME record is valid for 72 hours only.
   
2. The DNS settings must be updated and the verification CNAME record must be configured within this timeframe.

4.1 Verification CNAME Record – 1st Line:

1. In the DNS provider’s management panel, the leading underscore ( _ ) in the DNS record must not be omitted when entering the value.
   
2. If the system does not accept the input, the ending period ( . ) at the end of the value can be omitted.
   
3. Depending on the DNS provider, part of the name (hostname) may be set by default.
   In this case, enter the value so that it matches the first line of the verification CNAME record shown on the tripla admin screen.
   
   

4.2 CNAME Target

1. If the DNS provider’s settings page does not accept the input, the leading underscore ( _ ) and the ending period ( . ) may be omitted.
   
   

1. After completing the settings, the screen switches to “SSL Certificate Issuing DNS Validation”
   
2. Selecting [Test] allows checking the current progress of the verification process.
   

5. Register A Record

1. Register the IP address in the appropriate A record in DNS.

1. After completing the settings and selecting [Test], the following tabs are displayed depending on the status.
   

Title

IP Address for A record has not been correctly setup on your DNS setting.

CNAME record has not been correctly setup on your DNS setting.

CNAME record has timed out, please click reset to regenerate the record to try again.

---

6. SSL Certificate Renewal

The SSL certificate can be renewed from the admin screen before its expiration date.

This allows first party cookie tracking to continue without interruption.

■How to Renew:

Upload the new certificate file in “SSL Certificate Settings” and click [Reupload].

1. If the upload fails, the status changes to “Renew certificate failed”.
2. If the upload succeeds, the status changes to “Completed”.
3. The “Last Upload at” and “Expire Date” displayed near the [Reupload] button are updated accordingly.