Inleiding
Voor whitelabel resellers is het mogelijk onze web portal te ‘branden’ met bijvoorbeeld een eigen logo, een eigen kleur stelling en product naam. Eveneens is de URL van de web portal zelf te kiezen. Om dit laatste succesvol te laten verlopen middels een SSL verbinding zijn speciale maatregelen nodig.
Eigen URL met Letsencrypt certificaat
Onlinespamfilter biedt whitelabel resellers de mogelijkheid hun eigen URL te kiezen en middels HTTPS te verbinden met de onlinespamfilter portal. Na instelling van het DNS record zal automatisch een Letsencrypt SSL certificaat voor de reseller worden gegenereerd die vervolgens bij gebruik van de eigen URL aan de web browser wordt aangeboden. Het gevolg is een volledig beveiligde verbinding met de URL van de reseller.
Benodigde instellingen voor nieuwe whitelabel resellers
Om het bovenstaande te bereiken dienen de volgende instellingen te worden gemaakt:
Een geldig A-record in de DNS van de reseller die de gekozen URL verwijst naar het IP adres 185.150.184.172.
De betreffende URL moet worden ingevuld in het veld “Login url” onder Whitelabel opties in de web portal.
In hetzelfde scherm dient onderaan bij “Whitelabel domain settings” de tweede optie (Use HTTPS protocol with the reseller's login URL) te worden gekozen. Vergeet niet de instellingen op te slaan.
Binnen uiterlijk 10 minuten zal nu het certificaat automatisch worden gegenereerd en kan de URL in gebruik worden genomen.
Instellingen voor legacy implementaties
Wanneer er reeds in het verleden een oplossing is gebruikt (zoals Cloudflare of een URL zonder SSL encryptie) is de procedure iets uitgebreider:
Noteer de huidige ingestelde TTL (Time-To-Live) waarde voor het reseller A-record. Dit is de originele TTL waarde.
Breng de TTL van het A-record vervolgens tijdelijk terug naar de laagst mogelijke waarde. Dit is de tijdelijke TTL. Let op: Voor veel DNS providers geldt een minimale waarde van 60 seconden, maar sommige DNS resellers hebben een minimale waarde van 600 seconden.
Wacht tot de originele TTL verstreken is. Dit kan in sommige gevallen 24 uur tot een week bedragen afhankelijk van de waarde van de originele TTL.
Volg nu de stappen bij “Benodigde instellingen voor nieuwe whitelabel resellers”.
Na verloop van de ingestelde tijdelijke TTL + 10 minuten zal het certificaat gegenereerd zijn en kan de nieuwe URL worden gebruikt.
Indien gewenst kan de tijdelijke TTL weer worden verhoogd.
Bij legacy implementaties is er een korte periode waarin de gebruiker kan worden geconfronteerd met een ongeldig SSL certificaat. Dit is geen veiligheidsrisico maar kan als storend worden ervaren. Het advies is dan ook om een overgang van een legacy implementatie naar deze oplossing in te plannen op een rustig moment.
Het is mogelijk om de overgangsperiode in te korten. Hiervoor is handmatig ingrijpen van een Onlinespamfilter administrator nodig. We zijn hiertoe graag bereid. Neem svp hiervoor ruim op tijd contact op zodat we samen een goed moment kunnen plannen.
Onderstaande documentatie is alleen nog geldig voor legacy implementaties. Wij adviseren deze documentatie niet meer te gebruiken voor nieuwe implementaties. Ook adviseren wij om, wanneer het gelegen komt, over te schakelen naar bovenstaande oplossing. Deze is simpeler, completer en veiliger en vergt minder onderhoud.
Legacy documentatie (ter referentie)
Twee smaken
In principe zijn er twee mogelijkheden:
U kunt kiezen voor een URL binnen uw eigen domein. U bent dan zelf verantwoordelijk voor de beveiliging middels SSL. Dit kan middels een transparante proxy die u zelf configureert of bijvoorbeeld middels een Cloudflare instance met de Full SSL optie. U pareert hiermee de mismatch die ontstaat tussen ons SSL certificaat en de hostname. Deze optie is volledig veilig en biedt de beste branding.
U kunt gebruik maken van onze ‘unbranded’ domein naam: spamfilteronline.nl. Onlinespamfilter beheert de certificaten voor dit domein en zorgt er voor dat de gehele SSL chain op orde is. De login pagina is volledig ‘branded’ naar uw eigen voorkeuren. Een URL met dit domein werkt alleen met de juiste unieke ‘reseller token’.
Met de juiste reseller token in de URL worden bezoekers onmiddellijk doorgeleid naar de ‘branded’ login pagina van de reseller. Een voorbeeld van zo’n URL met token is de volgende: https://login.spamfilteronline.nl/admin/login?reseller=<token>
Uw unieke login URL met de juiste reseller token vindt u in de Whitelabel sectie onder “Token”.
URL’s in e-mails
Om zeker te stellen dat ook de e-mails die wij verzenden (voor logins / bounces / waarschuwingen) aan uw eindgebruikers ook de juiste URL’s bevatten dient u nog een instelling te maken in uw whitelabel instellingen. Deze instelling vindt u onderaan de eerste Whitelabel instellingen pagina bij “Login Domain used in mails”.
Wanneer u gebruik maakt van de eerste optie dient u voor deze instelling de tweede radio button:
Wanneer u gebruik maakt van de tweede optie gebruikt u de onderste radio button:
