Release Notes - ValidSign v2.0.0 – ValidSign

Welkom bij versie 2.0.0 van het ValidSign-platform. Hieronder vindt u een overzicht van de wijzigingen in deze release.

Backwards compatibiliteit

Bij de ontwikkeling van onze nieuwe backend hebben wij maximale inspanningen geleverd om volledige backwards compatibiliteit te garanderen. Het overgrote deel van de bestaande integraties en koppelingen blijft ongewijzigd functioneren. Op een beperkt aantal onderdelen was het echter onvermijdelijk om kleine wijzigingen door te voeren. Deze wijzigingen zijn hieronder per endpoint gedocumenteerd.

Nieuwe functionaliteit

Onderstaande tabel bevat een overzicht van de nieuwe functionaliteit die met deze release beschikbaar komt.

Functionaliteit

Onderdeel

Beschrijving

Custom branding

FRONTEND

Admin

Admins kunnen zelf custom branding toepassen
Via het nieuwe Create brand-scherm in de frontend stellen admins zelfstandig een eigen merkprofiel samen, zonder tussenkomst van support.

Per merk zijn de volgende elementen te configureren:

Brand name — de naam van het merkprofiel.
Application logo en Email logo — afzonderlijke logo's voor de applicatie en voor uitgaande e-mails (max. 2 MB, PNG/JPG/GIF).
Color settings — kleuren voor tekst, links, knopachtergrond en knoptekst, met directe preview van het resultaat.

Na het opslaan kan het merkprofiel direct worden toegewezen, zodat uw gebruikers en ontvangers consistent uw eigen huisstijl ervaren binnen het ValidSign-platform.

Multi-factor authenticatie (MFA)

FRONTEND

Alle gebruikers

Multi-factor authenticatie (MFA) is vanaf deze release verplicht binnen het ValidSign-platform, tenzij gebruik wordt gemaakt van verplichte SSO-login. In dat geval is MFA binnen ValidSign niet van toepassing. Hiermee voegt u een extra beveiligingslaag toe aan uw account.

Een uitgebreide stapsgewijze uitleg over het inschakelen en gebruiken van MFA vindt u in de bijbehorende handleiding: Setting Up Two-Factor Authentication (MFA).

Gewijzigde functionaliteit

Onderstaande tabel bevat een overzicht van bestaande functionaliteit die met deze release is aangepast.

Functionaliteit Onderdeel Beschrijving

Signing URL vernieuwt na transactiewijziging PLATFORM

Ondertekenaars Signing link wordt ongeldig zodra een transactie wordt gewijzigd
Wanneer een transactie wordt gewijzigd en opnieuw verstuurd, wordt de oorspronkelijke signing link niet langer hergebruikt.

Voorheen: De bestaande signing URL bleef geldig, ook nadat de transactie was aangepast en opnieuw verstuurd.
Nu: Bij elke wijziging en herverzending van een transactie wordt een nieuwe signing URL gegenereerd en aan de ondertekenaar verzonden. De voorgaande URL is daarmee niet meer bruikbaar.

Speciale karakters niet meer toegestaan in namen

PLATFORM

Alle gebruikers

Strengere validatie op gebruikers- en ontvangersnamen
Een aantal speciale karakters wordt niet langer geaccepteerd in gebruikersnamen en in de namen van ontvangers.

De volgende karakters worden geweigerd:

, & < > " / # % ( ) [ ] { } | : ; ? ! =

Controleer bij het aanmaken of bewerken van gebruikers en ontvangers of de ingevoerde namen geen van bovenstaande karakters bevatten. Bestaande integraties dienen hier rekening mee te houden bij het aanleveren van naamgegevens.

Reply-to gelijk aan afzenderadres PLATFORM

Alle gebruikers Reply-to-adres is altijd gelijk aan het afzenderadres
Het reply-to-adres van uitgaande e-mails komt nu altijd overeen met het daadwerkelijke from-adres.

Voorheen: Het was mogelijk om een afwijkend reply-to-adres in te stellen, los van het from-adres.
Nu: Het reply-to-adres wordt automatisch gelijkgetrokken met het from-adres. Een ander reply-to-adres instellen dan het daadwerkelijke from-adres is niet meer mogelijk.

API-wijzigingen

Onderstaande tabel bevat een overzicht van alle endpoints waar een wijziging is doorgevoerd. Controleer of uw integratie gebruikmaakt van deze endpoints en pas deze waar nodig aan.

Endpoint	Methode	Wijziging
`api/account/senders`	POST	Mobiel telefoonnummer vereist nu landcode Het veld voor het mobiele telefoonnummer accepteert niet langer nummers zonder landcode. Voorheen: `0622022222` Nu: `+31622022222` Alle telefoonnummers dienen in internationaal E.164-formaat te worden aangeleverd, inclusief de landcode voorafgegaan door een plusteken (+).
`api/account/senders`	POST	Status `ACTIVE` wordt niet langer ondersteund bij aanmaken Het is niet langer mogelijk om een gebruiker direct te activeren door de status `ACTIVE` mee te sturen in de payload. Voorheen: Een gebruiker kon direct worden geactiveerd door `"status":"ACTIVE"` op te nemen in het request. Nu: Elke nieuwe gebruiker doorloopt verplicht de registratieflow en dient zelf de accountactivatie af te ronden. Het meesturen van een status in de payload heeft geen effect meer op de activatie.
`api/account/senders/{senderId}`	DELETE	Gebruiker wordt direct verwijderd in plaats van vergrendeld Dit endpoint verwijdert de gebruiker nu direct en definitief, inclusief alle bijbehorende transacties. Voorheen: De gebruiker werd vergrendeld (locked) wanneer er nog actieve transacties aanwezig waren. Nu: De gebruiker wordt direct verwijderd, ongeacht actieve transacties. Alle gekoppelde transacties worden eveneens verwijderd.
`api/authenticationTokens/sender`	POST	Sender authentication token is nu daadwerkelijk transactie-scoped Het sender authentication token geeft nu uitsluitend toegang tot de specifieke transactie (package) waarvoor het is uitgegeven, zoals oorspronkelijk gedocumenteerd. Voorheen: Bij het opvragen van een sender authentication token werd in de praktijk een token uitgegeven met dezelfde scope als een `user authentication token` — dat wil zeggen volledige toegang tot het account. Nu: Het token is correct transactie-scoped en geeft uitsluitend toegang tot de bijbehorende `packageId`. Voor accountbrede toegang dient het endpoint `api/authenticationTokens/user` te worden gebruikt. Controleer of uw integratie het juiste endpoint gebruikt voor de gewenste scope. Integraties die onbedoeld vertrouwden op de bredere scope van het sender token dienen te worden aangepast naar het user authentication token.

Vragen of ondersteuning nodig?

Heeft u vragen over deze wijzigingen of hulp nodig bij het aanpassen van uw integratie? Neem dan contact op met ons support-team via support@validsign.eu.