Practical guide

How to Share API Keys and Access Tokens More Safely

A narrower workflow for sending a short-lived token without leaving its readable value in chat.

Published: July 2, 2026

Current implementation boundary

Current Collogue links carry the encrypted payload in the URL. The browser uses Web Crypto API: PBKDF2-SHA-256 with 310,000 iterations derives a 256-bit AES-GCM key from the separately entered password, with a random 16-byte salt and a 12-byte IV. The current client has no application API request for creating, retrieving, or storing messages.

The password is not encoded in the link. The implementation does not provide one-time viewing, server-side deletion, or an expiry timer. Treat the full link as sensitive and share the password through a separate channel.

Further context

Direct answer: Create a scoped, short-lived, revocable token; place only the token in a Collogue message; deliver the link to a verified recipient; rotate the token after the task; and treat unexpected link access as exposure.

An API token is a password that software can use quickly and repeatedly.

That makes careless delivery particularly expensive.

A temporary private link reduces one part of that exposure. The token design must handle the rest.

The safest delivery system cannot repair excessive privileges.

Avoid sending a broad production administrator token for a narrow task.

A private message should not contain an entire deployment map.

``text Temporary deployment token: [generated token] ``

Avoid putting endpoint, username, token, and privileged instructions together when that would significantly increase impact.

Check the recipient’s identity and role.

Social engineering often succeeds before cryptography begins.

If the decryption key is carried by the link, the link itself is sensitive.

A token that remains valid indefinitely turns a temporary delivery improvement into a permanent authorization risk.

  1. revoke the token;
  2. inspect target-platform audit logs;
  3. create a new scoped token;
  4. verify the recipient;
  5. send a new Collogue link;
  6. review the delivery channel.

Do not wait for proof of abuse. Revocation is often cheaper than certainty.

  1. Create a token limited to one repository and one action.
  2. Set an expiration of one hour or the shortest practical period.
  3. Create a Collogue message containing only the token.
  4. Send the link privately to the verified engineer.
  5. Send context in the approved change ticket.
  6. The engineer completes the action.
  7. Revoke the token.
  8. Review the audit record.

The delivery link reduces persistence. Scope and revocation reduce authority and lifetime.

All three matter.

It can reduce readable retention in Slack, but channel membership, account compromise, link previews, and scanners still matter. Use the narrowest private destination.

Usually, a short-lived scoped token plus verified delivery is simpler. Splitting can help only when channels are meaningfully independent and the process is reliable.

No. It is a human-oriented temporary sharing mechanism, not an automated secrets lifecycle and access-control platform.

Revoke it, inspect activity, create a new scoped token, and verify the recipient before resending.

Create a private Collogue link for a scoped, revocable token, then rotate the credential after the task.

Related reading