Créer vos identifiants API Airtable : Personal Access Token et OAuth

Avant de connecter Airtable à votre logiciel sur mesure, il faut générer un Personal Access Token avec les bons scopes et les bonnes restrictions. Ce guide vous explique la procédure complète, du choix du type d'accès à la transmission sécurisée du token.

LES ÉTAPES

3 étapes pour créer et sécuriser vos identifiants API Airtable

Avant de connecter Airtable à votre logiciel sur mesure, il faut générer les bons identifiants avec les bonnes permissions. Voici les étapes à suivre.

Choisir le bon type d'accès

Personal Access Token pour les connecteurs côté serveur, OAuth 2.0 pour les applications multi-utilisateurs. Le choix dépend de qui exécute les requêtes.

Créer le token en 5 minutes

Accès aux paramètres de compte Airtable, création du token avec un nom descriptif, sélection des scopes au strict nécessaire et restriction aux bases concernées. La valeur n'est affichée qu'une seule fois : à copier immédiatement.

Sécuriser et transmettre le token

Stockage en variable d'environnement, jamais dans le code source. Transmission via gestionnaire de mots de passe partagé, jamais par email ou Slack en clair.

Étape 1 : Choisir le bon type d’accès

Airtable propose deux méthodes d’authentification. Le bon choix dépend de votre cas d’usage : un connecteur côté serveur dans la plupart des cas, ou une application multi-utilisateurs si chaque utilisateur doit se connecter avec son propre compte Airtable.

Personal Access Token (recommandé)

Le Personal Access Token est lié à votre compte Airtable et utilise des scopes granulaires : lecture, écriture, gestion des bases. C’est l’option la plus simple pour un connecteur côté serveur, une synchronisation, un portail client ou une automatisation. Il est aussi plus rapide à créer et à révoquer qu’un flux OAuth.

OAuth 2.0

OAuth 2.0 est destiné aux applications qui doivent agir au nom de plusieurs utilisateurs Airtable. La mise en place est plus complexe — flux d’autorisation, gestion des refresh tokens — mais elle devient nécessaire si chaque utilisateur final doit s’authentifier avec son propre compte.

Étape 2 : Créer un Personal Access Token

Le Personal Access Token est la méthode la plus rapide pour connecter Airtable à un système externe. Voici la procédure complète.

Étape 1 : ouvrir les paramètres de compte

Connectez-vous à Airtable, puis ouvrez les paramètres de votre compte. Dans la section dédiée aux tokens d’accès personnels, vous pouvez commencer la création d’un nouveau token.

Étape 2 : nommer le token

Cliquez sur Create a token et donnez-lui un nom explicite, par exemple Connecteur-Facturation-Production ou Portail-Client-Lecture. Un nom clair facilite l’audit et la révocation plus tard.

Étape 3 : sélectionner les scopes

Choisissez uniquement les permissions nécessaires au connecteur :

data.records:read pour lire les enregistrements
data.records:write pour créer ou modifier des enregistrements
schema.bases:read pour lire la structure des bases et des tables

Le principe du moindre privilège reste essentiel : moins un token a de permissions, plus il est sûr en cas de fuite.

Étape 4 : restreindre les bases

Limitez l’accès aux bases réellement nécessaires. Évitez de donner accès à toutes les bases si le connecteur n’en utilise qu’une ou deux. Cette restriction réduit fortement l’impact d’une fuite éventuelle.

Étape 5 : copier et stocker le token

Après validation, Airtable affiche la valeur du token une seule fois. Copiez-la immédiatement dans un gestionnaire de secrets ou de mots de passe : elle ne sera plus visible ensuite.

Références

Étape 3 : Sécurité

Sécuriser et transmettre votre token

Un token Airtable donne accès à vos données métier. Quelques règles simples évitent les fuites accidentelles et permettent une révocation rapide en cas de problème.

Ne jamais committer le token

Un token dans un dépôt git (même privé) est une fuite de sécurité. Il doit toujours passer par une variable d'environnement dans votre .env local, jamais dans le code source.

Variable d'environnement côté serveur

Sur Clever Cloud (notre infrastructure d'hébergement), les variables d'environnement sont configurées depuis la console et injectées au démarrage de l'application. Elles ne sont jamais exposées côté client.

Comment nous le transmettre

Utilisez un gestionnaire de mots de passe partagé (Bitwarden, 1Password) ou notre formulaire de partage sécurisé. Jamais par email ou par message Slack en clair.

FAQ

Les réponses à vos questions

Et si vous ne trouvez pas ce que vous cherchez, nous serons ravis de vous répondre en direct lors d'un rendez-vous entre humains !

Oui, Airtable ne limite pas le nombre de tokens. Créer un token par environnement (développement, staging, production) et par connecteur permet de révoquer un accès précis sans impacter les autres systèmes.

Les Personal Access Tokens Airtable n'ont pas de date d'expiration par défaut. Il est recommandé de les révoquer et regénérer régulièrement, ou immédiatement en cas de doute sur une fuite.

Pour aller plus loin

Approfondir votre réflexion

Retour : Expert API Airtable

Portail client, tableau de bord, synchronisation : découvrez tous les cas d'usages que nous pouvons développer avec l'API Airtable.

Notre stack technique

Symfony, Vue.js, Clever Cloud : les technologies que nous utilisons pour développer des connecteurs robustes et maintenables.