<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Peter Zamiška</title>
    <description>The latest articles on DEV Community by Peter Zamiška (@xzamiska).</description>
    <link>https://dev.to/xzamiska</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4241690%2F9c10b5b0-5cc1-4be6-9e23-61781a32c801.png</url>
      <title>DEV Community: Peter Zamiška</title>
      <link>https://dev.to/xzamiska</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/xzamiska"/>
    <language>en</language>
    <item>
      <title>How we hide private data in bug report screenshots</title>
      <dc:creator>Peter Zamiška</dc:creator>
      <pubDate>Mon, 16 Nov 2026 14:00:00 +0000</pubDate>
      <link>https://dev.to/xzamiska/how-we-hide-private-data-in-bug-report-screenshots-1ojd</link>
      <guid>https://dev.to/xzamiska/how-we-hide-private-data-in-bug-report-screenshots-1ojd</guid>
      <description>&lt;p&gt;A bug report without a screenshot is a guessing game. A bug report &lt;em&gt;with&lt;/em&gt; a screenshot is a copy of whatever was on your customer's screen: their customers' e-mail addresses, phone numbers, the card on file, a health note typed into a form. That image then sits in your tracker, gets pasted into Slack and ends up in an AI assistant's context.&lt;/p&gt;

&lt;p&gt;Ozvi's widget takes the screenshot for the person reporting the bug. It also makes sure the private parts never become pixels. Here is how, and what you can turn up or down.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fq4r7p4757ry18o6b1gl9.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fq4r7p4757ry18o6b1gl9.webp" alt="A member list with names, e-mail addresses, phone numbers, a card number and a health note, all readable" width="799" height="298"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;What the customer sees. Everything in this sample app is made up.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F2vu2kaz0vs2yiv7wyrva.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F2vu2kaz0vs2yiv7wyrva.webp" alt="The same page in the screenshot Ozvi sends: e-mails, phone numbers and the card number are solid boxes, form fields show dots" width="800" height="324"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;What reaches the team: the screenshot exactly as Ozvi stores it.&lt;/em&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  Mask the copy, not the image
&lt;/h2&gt;

&lt;p&gt;The usual approach is to take a screenshot and blur parts of it afterwards. Blur is a filter on pixels that already contain the data, and blurred text can often be reconstructed. Painting a box over the image is better, but the original image still exists for a moment, and anything the box misses is gone.&lt;/p&gt;

&lt;p&gt;Ozvi never has an unmasked image. The widget draws the screenshot from a &lt;strong&gt;copy&lt;/strong&gt; of the page (the DOM is cloned, then rendered to a canvas). Every element of that copy passes through the masking step before it is drawn. The page the person is looking at is never touched, so nothing flickers.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// packages/widget/src/shot.ts (simplified)&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;image&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="nf"&gt;domToBlob&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;document&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;documentElement&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="c1"&gt;// runs on the clone, before anything is drawn&lt;/span&gt;
  &lt;span class="n"&gt;onCloneNode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;clone&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;maskScreenshot&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;clone&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;mode&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If masking throws for any reason, there is no screenshot at all. Never an unmasked one.&lt;/p&gt;

&lt;h2&gt;
  
  
  What is covered without any setup
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Form values.&lt;/strong&gt; Every input, textarea and select. A filled field shows a few dots, so the team still sees that something was typed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;E-mail addresses, phone numbers, IBANs, card numbers and tokens&lt;/strong&gt; found in text anywhere on the page. Card numbers are Luhn-checked; phone numbers need 9 to 15 digits, so dates and prices stay readable.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Anything inside &lt;code&gt;data-ozvi-mask&lt;/code&gt;&lt;/strong&gt;, including images, canvas and video.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Covered text is not removed. Its colour turns transparent and its element gets a solid background, so the layout stays exactly the same and the team can still see where things were.&lt;/p&gt;

&lt;h2&gt;
  
  
  Names and other things without a shape
&lt;/h2&gt;

&lt;p&gt;An e-mail address has a recognisable shape; "Amelia Grant" does not. For names, notes and anything else that is private in your app, add one attribute:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;td&lt;/span&gt; &lt;span class="na"&gt;data-ozvi-mask&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;{member.name}&lt;span class="nt"&gt;&amp;lt;/td&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Health care, finance: cover everything
&lt;/h2&gt;

&lt;p&gt;Some apps should not send any text at all. Turn the default around: everything is covered except what you explicitly allow, such as the navigation and the page title.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="nb"&gt;window&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nc"&gt;OzviConfig&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;mask&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"all"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// and in your markup:&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;nav&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;ozvi&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;unmask&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;…&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;nav&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;h1&lt;/span&gt; &lt;span class="n"&gt;data&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;ozvi&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;unmask&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="nc"&gt;Members&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;/&lt;/span&gt;&lt;span class="n"&gt;h1&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The team still sees the layout and where something broke, without any of the data.&lt;/p&gt;

&lt;h2&gt;
  
  
  The rest of the report
&lt;/h2&gt;

&lt;p&gt;The screenshot is only one part of what the widget sends. The steps before the report, the failed requests and console errors are masked in the browser too, before they are kept in memory. Secrets in addresses (tokens, passwords, e-mails in a path or a parameter) are replaced, request headers are never recorded, and request or response bodies are kept only for failed requests and only if you turn that on, cut short and masked with the same patterns. The Ozvi server masks everything a second time.&lt;/p&gt;

&lt;p&gt;The full list of what a report captures is in the &lt;a href="https://ozvi.io/docs/widget#privacy" rel="noopener noreferrer"&gt;widget docs&lt;/a&gt;, and the code is public: &lt;a href="https://github.com/xzamiska/ozvi/blob/main/packages/widget/src/shot-mask.ts" rel="noopener noreferrer"&gt;shot-mask.ts&lt;/a&gt; (MIT).&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Ozvi puts bug reports, an idea board, a roadmap and a changelog inside your app. Source-available, self-host free or use the cloud: &lt;a href="https://ozvi.io/?utm_source=devto&amp;amp;utm_campaign=screenshot-privacy" rel="noopener noreferrer"&gt;ozvi.io&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>privacy</category>
      <category>webdev</category>
      <category>security</category>
    </item>
    <item>
      <title>Sign your users in to an embedded widget with one signed token</title>
      <dc:creator>Peter Zamiška</dc:creator>
      <pubDate>Fri, 13 Nov 2026 14:00:00 +0000</pubDate>
      <link>https://dev.to/xzamiska/sign-your-users-in-to-an-embedded-widget-with-one-signed-token-3oml</link>
      <guid>https://dev.to/xzamiska/sign-your-users-in-to-an-embedded-widget-with-one-signed-token-3oml</guid>
      <description>&lt;p&gt;A feedback widget is only useful if it knows who is talking. "Someone" reported a bug on the invoice page is a dead end; "Sarah from Pilates House, on the Pro plan" is a conversation. But nobody wants to log in a second time to report a bug, and you don't want a third-party account system next to yours.&lt;/p&gt;

&lt;p&gt;Ozvi solves it the way most embedded tools should: your backend, which already knows who is signed in, signs a short statement ("this is user u-42, sarah@…, role member") and the widget passes it along. Ozvi checks the signature and trusts it. No redirect, no password, no Ozvi account for your users.&lt;/p&gt;

&lt;h2&gt;
  
  
  The whole flow
&lt;/h2&gt;

&lt;ol&gt;
&lt;li&gt;The widget calls an endpoint in &lt;em&gt;your&lt;/em&gt; app, the &lt;code&gt;token-url&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Your endpoint checks your own session and returns &lt;code&gt;{ "token": "…" }&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;The widget sends the token with every request to Ozvi and caches it until shortly before it expires.
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight html"&gt;&lt;code&gt;&lt;span class="nt"&gt;&amp;lt;script&lt;/span&gt; &lt;span class="na"&gt;src&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"https://feedback.your-app.com/widget.js"&lt;/span&gt; &lt;span class="na"&gt;defer&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/script&amp;gt;&lt;/span&gt;
&lt;span class="nt"&gt;&amp;lt;ozvi-widget&lt;/span&gt; &lt;span class="na"&gt;project&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"your-app"&lt;/span&gt; &lt;span class="na"&gt;token-url&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;"/api/ozvi-token"&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;/ozvi-widget&amp;gt;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The secret that signs the token is shared between your server and Ozvi (board settings → Sign-in). It never goes to the browser.&lt;/p&gt;

&lt;h2&gt;
  
  
  The token is a plain JWT
&lt;/h2&gt;

&lt;p&gt;No proprietary format: a JSON Web Token signed with HMAC-SHA256 (&lt;code&gt;HS256&lt;/code&gt;), valid for ten minutes. That means any language can make one with its standard library.&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Field&lt;/th&gt;
&lt;th&gt;What it is&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;id&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Required. The person's stable id in your app. Ozvi keys on it, never on the e-mail alone.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;email&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Optional. Used for replies ("fixed in 3.9.2, does it work for you?").&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;name&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Optional. Shown to your team.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;role&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;member&lt;/code&gt; (default), &lt;code&gt;team&lt;/code&gt; (can triage) or &lt;code&gt;admin&lt;/code&gt; (can change settings).&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;traits&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Optional, team-only: company, plan, mrr in cents… so you can sort ideas by revenue.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;iat&lt;/code&gt;, &lt;code&gt;exp&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;Issued at and expiry, in seconds. Keep it short-lived.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h2&gt;
  
  
  Node.js
&lt;/h2&gt;

&lt;p&gt;With the MIT-licensed SDK (no dependencies), &lt;code&gt;npm i @ozvi/sdk&lt;/code&gt;:&lt;br&gt;
&lt;br&gt;
```tsimport { signOzviToken } from "@ozvi/sdk";app.get("/api/ozvi-token", requireLogin, (req, res) =&amp;gt; {&lt;br&gt;
  res.json({ token: signOzviToken(&lt;br&gt;
    { id: req.user.id, email: req.user.email, name: req.user.name,&lt;br&gt;
      traits: { company: req.org.name, plan: req.org.plan } },&lt;br&gt;
    process.env.OZVI_SSO_SECRET) });&lt;br&gt;
});&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;
typescript

In Next.js the same goes into `app/api/ozvi-token/route.ts`:



```ts
import { signOzviToken } from "@ozvi/sdk";import { auth } from "@/auth"; // your session

export async function GET() {
  const session = await auth();
  if (!session?.user) return new Response(null, { status: 401 });
  const { id, email, name } = session.user;
  return Response.json({ token: signOzviToken({ id, email, name }, process.env.OZVI_SSO_SECRET!) });
}
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Python (standard library only)
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;import&lt;/span&gt; &lt;span class="n"&gt;base64&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;hashlib&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;hmac&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;time&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;ozvi_token&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;user&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;dict&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;secret&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;str&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;os&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;environ&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"OZVI_SSO_SECRET"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt; &lt;span class="kt"&gt;str&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;b64&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;lambda&lt;/span&gt; &lt;span class="n"&gt;o&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;base64&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;urlsafe_b64encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;dumps&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;o&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;separators&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;","&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;":"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;rstrip&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="s2"&gt;"="&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;decode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;now&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kt"&gt;int&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;time&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;time&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;body&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s1"&gt;'{b64({"alg": "HS256", "typ": "JWT"})}.{b64({**user, "iat": now, "exp": now + 600})}'&lt;/span&gt;
    &lt;span class="n"&gt;sig&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;hmac&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;new&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;secret&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;body&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;hashlib&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;sha256&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;digest&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;f&lt;/span&gt;&lt;span class="s2"&gt;"{body}.{base64.urlsafe_b64encode(sig).rstrip(b'=').decode()}"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  PHP (no Composer package)
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight php"&gt;&lt;code&gt;&lt;span class="k"&gt;function&lt;/span&gt; &lt;span class="nf"&gt;ozvi_token&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;array&lt;/span&gt; &lt;span class="nv"&gt;$user&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="nv"&gt;$secret&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="nv"&gt;$secret&lt;/span&gt; &lt;span class="o"&gt;??=&lt;/span&gt; &lt;span class="nf"&gt;getenv&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'OZVI_SSO_SECRET'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nv"&gt;$b64&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="k"&gt;fn&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nf"&gt;rtrim&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;strtr&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;base64_encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$s&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'+/'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'-_'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'='&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nv"&gt;$now&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;time&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nv"&gt;$body&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nv"&gt;$b64&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;json_encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'alg'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'HS256'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'typ'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="s1"&gt;'JWT'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;.&lt;/span&gt; &lt;span class="s1"&gt;'.'&lt;/span&gt;
          &lt;span class="p"&gt;.&lt;/span&gt; &lt;span class="nv"&gt;$b64&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;json_encode&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nv"&gt;$user&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s1"&gt;'iat'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$now&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;'exp'&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nv"&gt;$now&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="mi"&gt;600&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="no"&gt;JSON_UNESCAPED_UNICODE&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="no"&gt;JSON_UNESCAPED_SLASHES&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nv"&gt;$body&lt;/span&gt; &lt;span class="p"&gt;.&lt;/span&gt; &lt;span class="s1"&gt;'.'&lt;/span&gt; &lt;span class="p"&gt;.&lt;/span&gt; &lt;span class="nv"&gt;$b64&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;hash_hmac&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'sha256'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;$body&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;$secret&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;All three produce tokens that Ozvi's own verifier accepts; we test them against it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Getting it right
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Keep it short-lived.&lt;/strong&gt; Ten minutes is plenty, the widget asks for a new one when it needs it. A leaked token is useless soon after.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sign only for signed-in users.&lt;/strong&gt; Check your own session first and return 401 without it; never sign whatever the browser sends you.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Use your stable id&lt;/strong&gt;, not the e-mail, as &lt;code&gt;id&lt;/code&gt;. People change e-mails.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Roles come from you.&lt;/strong&gt; Give &lt;code&gt;team&lt;/code&gt; only to your staff: they see every report and the customer data in &lt;code&gt;traits&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Don't paste real tokens into online decoders.&lt;/strong&gt; They carry your users' e-mails.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Everything the widget can do, from the JavaScript API to React and Vue components, is in the &lt;a href="https://ozvi.io/docs/widget" rel="noopener noreferrer"&gt;widget docs&lt;/a&gt;. Prefer OpenID Connect? Ozvi supports that too.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Ozvi puts bug reports, an idea board, a roadmap and a changelog inside your app. Source-available, self-host free or use the cloud: &lt;a href="https://ozvi.io/?utm_source=devto&amp;amp;utm_campaign=sign-in" rel="noopener noreferrer"&gt;ozvi.io&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>javascript</category>
      <category>webdev</category>
      <category>security</category>
      <category>saas</category>
    </item>
  </channel>
</rss>
