Identité et autorisations
- Leçon 15
- 55 min
- Module 5 : Accès à distance et autorisation
Où nous en sommes
Dans la leçon précédente, nous avons exposé support-mcp avec HTTP, avec un jeton d'accès dans chaque requête. Mais un jeton prouve qui est l'appelant, pas ce qu'il peut faire dans une organisation. Dans cette leçon, nous transformons un jeton vérifié et un en-tête en décision sur le serveur, et nous nommons la vérification qui a refusé chaque requête. Nous commençons par une réception qui pose trois questions.
Leçon 15 sur 22 · MCP : connecter les applications d'IA aux outils et aux donnéesIdentité et autorisations
1. Comprendre le problème d'intégration
2. Concevoir des capacités de serveur utiles
3. Créer et examiner un serveur local
4. Connecter une application d'IA
5. Accès à distance et autorisation
6. Protéger les outils et le contrôle de l'utilisateur
7. Exploiter et maintenir l'intégration
Ce que vous saurez faire
Décidez, sur le serveur, de ce que chaque appelant distant peut faire. Vous transformez un jeton vérifié et un en-tête en appelant associé à une organisation, un rôle et des portées. Ensuite, vous observez 48 vraies requêtes provenant de douze appelants. Vous nommez la vérification qui a refusé chacune.
Avant de commencerCe qu’il faut savoir et avoir sous la main
Ce que vous devez savoir
- Le serveur distant, son fournisseur d’exercice et un jeton d’exercice, dans Transport à distance.
- Les organisations, les adhésions et les rôles, dans Trois questions distinctes et Requêtes sûres pour chaque locataire du cours sur l’authentification.
Votre projet
~/projects/support-mcpaprès Transport à distance :python -m pytest -qaffiche49 passed(49 tests réussis), et.idp/contient la clé d’exercice.- Le terminal 1 exécute
python -m idp, le terminal 2 exécutepython -m support_mcp --http, le terminal 3 est libre. L’environnement virtuel est actif dans chacun.
La réception pose trois questions
Section intitulée « La réception pose trois questions »Un immeuble de bureaux accueille plusieurs entreprises sur ses étages. À la réception, un visiteur présente une carte de la ville. La carte prouve son identité. Elle ne dit pas dans quelle entreprise il peut entrer.
Une bonne réception pose donc trois questions distinctes. Qui êtes-vous? Montrez votre carte. Quelle entreprise visitez-vous? Votre nom figure-t-il sur sa liste? Que pouvez-vous y faire? Un visiteur peut s’asseoir dans la salle de réunion, mais pas ouvrir la caisse. Le cours sur l’authentification utilisait la même réception. Ici, la réception est le serveur MCP. Il pose les trois questions pour chaque requête.
Le problème : un jeton valide n’est pas une autorisation
Section intitulée « Le problème : un jeton valide n’est pas une autorisation »Ines est propriétaire de Bramble Books. Son jeton est authentique : le fournisseur d’exercice l’a signé, il vise ce serveur et il n’a pas expiré. Et si le serveur s’arrêtait à « le jeton est valide »? Ines pourrait alors définir X-Support-Tenant: larkfield et lire les billets de soutien de Larkfield.
Tomás a deux autres idées. « Mettez l’organisation et le rôle dans le jeton, dit-il, comme ça le serveur peut leur faire confiance. » Mais Camille fait partie du personnel de Larkfield et a un accès en lecture seule chez Bramble Books. Un seul rôle dans son jeton serait incorrect dans l’une des deux boutiques. Sa deuxième idée : « L’hôte peut masquer les outils aux personnes qui ne peuvent pas les utiliser. » Kwame pose sa question habituelle : « Qui appelle, que peut faire cette personne, et dans quelle organisation? » Un hôte qui masque un outil ne répond à aucune de ces questions. Tout autre client peut encore envoyer la requête.
Voici ce que fait le serveur avec le jeton valide d’Ines et la mauvaise organisation. C’est une vraie exécution :
[host] discovered 2 tools: search_knowledge, get_ticket {"protocol": "2026-07-28", "server": "support-mcp"}[model] wants get_ticket {"arguments": {"ticket_id": "T-30002"}}[host] read-only tool on the allow-list: run it {"decision": "auto"}[server] protocol error -32003: forbidden: you have no access to this organization {"code": -32003}Le jeton a passé la vérification : il n’y a pas eu de réponse 401. Une deuxième vérification, après celle du jeton, a refusé la requête.
L’idée : authentification, puis autorisation
Section intitulée « L’idée : authentification, puis autorisation »Le cours sur l’authentification séparait le travail en deux. L’authentification répond à « qui appelle? ». Le jeton le prouve, et le serveur vérifie la preuve. L’autorisation répond à « que peut faire cette personne ici? ». Le serveur le décide à partir de ses propres données, pour chaque requête.
Le serveur construit un appelant à partir de trois entrées. Le jeton vérifié fournit l’utilisateur (sub) et les portées. Elles indiquent ce que la personne a permis à cette application de faire, comme tickets:read. L’en-tête X-Support-Tenant fournit l’organisation, le locataire. La table des adhésions du serveur fournit le rôle de cet utilisateur dans cette organisation : propriétaire, personnel ou lecture seule. Une adhésion est une ligne de cette table. Sans ligne, il n’y a pas d’appelant, et la réponse est −32003.
Ensuite, la requête passe les vérifications dans un ordre fixe. D’abord le jeton, puis l’adhésion, puis la portée, puis le rôle : un document de politique est réservé au personnel. Enfin vient une recherche limitée à l’organisation : le serveur cherche uniquement dans les données de l’organisation de l’appelant. Un billet d’une autre organisation est donc « introuvable ». Chaque vérification qui refuse la requête l’arrête, et les vérifications suivantes ne s’exécutent jamais.
Description textuelle du diagramme
Trois entrées forment un appelant :
- Le jeton d’accès vérifié :
subvautusr-camille,scopevautknowledge:read tickets:read,audest l’URL du serveur. - L’en-tête de la connexion :
X-Support-Tenant: bramble. - La table des adhésions du serveur,
data/memberships.csv: Camille fait partie du personnel de Larkfield et a un accès en lecture seule chez Bramble Books.
L’appelant est usr-camille, dans l’organisation bramble, avec le rôle read_only et les deux portées du jeton. Sans ligne d’adhésion pour cet utilisateur et cette organisation, la réponse est −32003 « forbidden : you have no access to this organization » (interdit : vous n’avez pas accès à cette organisation).
L’authentification demande qui appelle; le jeton le prouve avec sa signature, son émetteur, son audience et son expiration. L’autorisation demande ce que cette personne peut faire ici : adhésion, portée, rôle et recherche limitée à cette organisation. Ces vérifications ont lieu à chaque requête, sur le serveur. Le jeton ne contient ni organisation ni rôle. Avec l’en-tête larkfield, le même jeton donne à Camille le rôle de personnel.
Un petit exemple : une personne, deux organisations
Section intitulée « Un petit exemple : une personne, deux organisations »Camille est le meilleur test, car cette personne a deux adhésions. Prenez un jeton et envoyez deux requêtes qui diffèrent uniquement par l’en-tête. Prédisez d’abord les deux réponses.
| En-tête | Rôle dans la table | get_ticket T-40003 (un billet de Bramble) |
|---|---|---|
X-Support-Tenant: larkfield |
personnel | not_found: there is no ticket T-40003 in this organization (introuvable : aucun billet T-40003 dans cette organisation) |
X-Support-Tenant: bramble |
lecture seule | le billet : « Book arrived damaged » (livre arrivé endommagé) |
Les deux réponses sont réelles. Chez Larkfield, Camille fait partie du personnel et a donc plus de droits que chez Bramble Books. Camille ne peut pourtant pas y voir un billet de Bramble, car le serveur cherche uniquement dans les données de Larkfield. Un identifiant absent et celui d’une autre organisation obtiennent la même réponse. L’erreur ne révèle donc rien.
Larkfield : lire le code de l’appelant
Section intitulée « Larkfield : lire le code de l’appelant »support_mcp/identity.py a une nouvelle fonction, http_caller. Chaque outil l’appelle d’abord, par caller(ctx) :
def http_caller(ctx) -> Caller: """The caller of a remote (Streamable HTTP) request: the validated token's user and scopes, the organization named by the connection's header, the role from the membership table.""" from mcp.server.auth.middleware.auth_context import get_access_token
token = get_access_token() if token is None or not token.subject: # the HTTP app refuses this before; checked again here raise forbidden("forbidden: no signed-in user") tenant = (ctx.headers or {}).get(TENANT_HEADER, "") return resolve(token.subject, tenant, token.scopes, token.client_id)
def resolve(user_id: str, tenant: str, scopes, client_id: str = "local") -> Caller: role = MEMBERSHIPS.get((user_id, tenant)) if role is None: # no membership, or no such organization: the same answer raise forbidden("forbidden: you have no access to this organization") return Caller(user_id, tenant, role, frozenset(scopes), client_id)get_access_token() renvoie le jeton que JwtVerifier a déjà vérifié. Un jeton refusé n’arrive jamais ici : la trousse SDK a déjà répondu 401. resolve est la même fonction que celle du serveur stdio. Seule la source de l’utilisateur et de l’organisation diffère. Un en-tête absent donne une organisation vide, qui n’a aucune adhésion : −32003.
La vérification de portée se trouve dans chaque outil, avant l’accès aux données :
who = caller(ctx)identity.require_scope(who, "tickets:read")try: t = knowledge.ticket(who.tenant, ticket_id)except NotFound: raise ToolError(f"not_found: there is no ticket {ticket_id} in this organization") from Noneknowledge.ticket(who.tenant, ticket_id) est la recherche limitée à l’organisation. L’organisation vient de who, jamais des arguments du modèle. La vérification du rôle se trouve à un seul endroit ici. knowledge.document(..., staff=who.staff) masque la procédure de remboursement réservée au personnel aux appelants en lecture seule. Ils obtiennent « Resource not found » (ressource introuvable), la même réponse que pour un document absent.
La couche HTTP ajoute une vérification avant MCP. required_scopes dans http.py liste les deux portées de lecture. Un jeton qui ne les possède pas reçoit donc HTTP 403 insufficient_scope (portée insuffisante) pour chaque requête. Intégration d’OAuth explique pourquoi le serveur annonce exactement ces deux portées.
Douze appelants, quatre requêtes
Section intitulée « Douze appelants, quatre requêtes »scripts/attempts.py envoie de vraies requêtes par Streamable HTTP. Il essaie douze appelants, avec quatre requêtes chacun, et nomme la vérification qui a refusé chaque requête. Il démarre son propre serveur et signe ses propres jetons. Il n’a donc besoin d’aucun autre terminal.
-
Dans le terminal 3, copiez les fichiers de cette leçon :
Fenêtre de terminal S=../nextia-learning-labs/C28/snapshots/end-of-m05cp "$S/scripts/attempts.py" scripts/cp "$S/tests/test_http.py" tests/Fenêtre de terminal $S = "..\nextia-learning-labs\C28\snapshots\end-of-m05"Copy-Item "$S\scripts\attempts.py" scripts\Copy-Item "$S\tests\test_http.py" tests\ -
Exécutez les tests :
Fenêtre de terminal python -m pytest -q............................................................... [100%]63 passed in 9.87sLes 14 nouveaux tests dans
tests/test_http.pyenvoient de vraies requêtes HTTP. Ils essaient six types de jetons incorrects, deux mauvaises organisations et un identifiant d’une autre organisation. Ils essaient aussi une portée manquante et une personne sans adhésion. -
Exécutez les tentatives et envoyez les lignes du journal du serveur dans un fichier :
Fenêtre de terminal python -m scripts.attempts 2> attempts-log.txtLe tableau (limité à cinq des douze appelants) :
usr-camille @ larkfield (token: valid, scopes: knowledge:read tickets:read)search policies ok allowedread a Larkfield ticket ok allowedread a Bramble ticket tool_error organization-scoped lookup (not in this organization)read the staff-only procedure ok allowedusr-camille @ bramble (token: valid, scopes: knowledge:read tickets:read)search policies ok allowedread a Larkfield ticket tool_error organization-scoped lookup (not in this organization)read a Bramble ticket ok allowedread the staff-only procedure refused role (the membership's role)usr-ines @ larkfield (token: valid, scopes: knowledge:read tickets:read)search policies refused membership (no membership here)...usr-sam @ larkfield (token: valid, scopes: knowledge:read)search policies refused scope (the token does not allow it)...usr-sam @ larkfield (token: wrong_audience, scopes: knowledge:read tickets:read)search policies refused token (signature, issuer, audience, expiry)...48 attempts: 15 allowed, 33 refused on the server.Votre tableau montre les douze appelants. Chaque refus s’est produit sur le serveur : aucun hôte ni modèle n’a participé.
La vérification du jeton a refusé 12 requêtes : aucun jeton, un jeton pour une autre API, un jeton expiré. La vérification d’adhésion en a refusé 8 (Ines chez Larkfield, Tomás), et celle de portée, 4. La vérification du rôle en a refusé 3 : la procédure réservée au personnel, pour les appelants en lecture seule. La recherche limitée à l’organisation en a refusé 6, chacune visant un billet d’une autre organisation.
Explorez maintenant les mêmes 48 tentatives. Chacune est une réponse enregistrée, pas une simulation.
Explorer
Quelle vérification arrête la requête?
Prédisez d’abord : Camille possède un jeton valide avec les deux portées de lecture. L'hôte de Camille envoie X-Support-Tenant : larkfield et demande le billet T-40003 de Bramble. Est-ce permis? Sinon, quelle vérification le refuse?
- Rôle dans cette organisation
- staff
- Le serveur répond
- Refusé (un résultat d’outil avec isError: true)
- Arrêté par
- Recherche limitée à l’organisation
Camille chez Larkfield : jeton valide, portées knowledge:read tickets:read : « Lire le billet Bramble T-40003 » est refusé par le contrôle 5 sur 5, Recherche limitée à l’organisation. Les contrôles suivants ne se sont jamais exécutés.
Les contrôles du serveur, dans l’ordre
- 1Jetonsignature, émetteur, audience, expirationréussi
- 2Adhésionl’utilisateur est membre de l’organisation de l’en-têteréussi
- 3Portéele jeton permet ce type de requêteréussi
- 4Rôlele rôle de l’adhésion permet cette action ou ce documentréussi
- 5Recherche limitée à l’organisationl’enregistrement existe dans cette organisationrefusé ici
Ce qui a été envoyé, et la vraie réponse
tools/call get_ticket {"ticket_id": "T-40003"}
Error executing tool get_ticket: not_found: there is no ticket T-40003 in this organization- permis
- refusé par le serveur
- seulement proposé
| Requête | Réponse | Arrêté par |
|---|---|---|
| Chercher dans les politiques | ok | – |
| Lire le billet Larkfield T-30002 | ok | – |
| Lire le billet Bramble T-40003 (choisi) | tool_error | Recherche limitée à l’organisation |
| Lire la procédure réservée au personnel | ok | – |
Chaque réponse est une vraie requête en Streamable HTTP, envoyée par python -m scripts.attempts --json au serveur du projet, avec des jetons signés par le fournisseur d’entraînement. Les personnes sont fictives.
Description textuelle de l’explorateur
L’explorateur montre les 48 tentatives de python -m scripts.attempts --json. Choisissez un appelant : une personne, l’organisation dans l’en-tête, un jeton et ses portées. Choisissez ensuite l’une des quatre requêtes. L’affichage donne le rôle, la réponse du serveur et la vérification qui a arrêté la requête. La chaîne liste les cinq vérifications du serveur dans l’ordre : jeton, adhésion, portée, rôle, recherche limitée à l’organisation. Chacune porte la mention réussie, refusée ici ou non atteinte. En dessous apparaissent la vraie requête et sa réponse, puis les quatre requêtes de l’appelant dans un tableau.
Le cas de départ : Camille chez Larkfield demande T-40003. Les vérifications du jeton, de l’adhésion, de la portée et du rôle réussissent. La recherche limitée à l’organisation refuse : not_found: there is no ticket T-40003 in this organization. Avec l’en-tête bramble, la même requête est permise. La vérification d’adhésion refuse les quatre requêtes d’Ines chez Larkfield, avec −32003. La vérification du jeton refuse un jeton pour une autre API avec HTTP 401, avant toute autre vérification. La vérification de portée refuse le jeton de Sam contenant uniquement knowledge:read, avec HTTP 403, même pour une recherche. Omar, en lecture seule chez Larkfield, peut chercher et lire des billets. Mais la vérification du rôle lui rend la procédure réservée au personnel « Resource not found » (ressource introuvable).
Masquer un outil n’est pas une autorisation
Section intitulée « Masquer un outil n’est pas une autorisation »Tomás n’a aucune adhésion. Que voit-il quand son hôte se connecte? Une vraie exécution, avec son jeton valide :
['search_knowledge', 'get_ticket']tools/list lui a montré les deux outils. Ensuite, chaque appel a été refusé :
[server] protocol error -32003: forbidden: you have no access to this organization {"code": -32003}[model] wants search_knowledge {"arguments": {"query": "Draft a reply to ticket"}}[host] read-only tool on the allow-list: run it {"decision": "auto"}[server] protocol error -32003: forbidden: you have no access to this organization {"code": -32003}[model] final answer
I could not use get_ticket: forbidden: you have no access to this organizationI could not use search_knowledge: forbidden: you have no access to this organizationC’est le fonctionnement prévu. Ici, la découverte n’exige pas d’adhésion : voir le nom et le schéma d’un outil ne donne aucune donnée. La spécification permet aussi au serveur de renvoyer une liste d’outils différente pour chaque appelant. C’est une bonne option pour un grand serveur. Le modèle voit alors moins d’outils qu’il ne peut pas utiliser. Mais une liste plus courte n’est pas un contrôle. Un client peut toujours envoyer un tools/call pour un nom qu’il n’a jamais vu. Le serveur doit donc vérifier chaque appel de toute façon.
À vous : changez uniquement l’en-tête
Section intitulée « À vous : changez uniquement l’en-tête »Utilisez les jetons de Camille et d’Ines avec l’hôte du cours. Changez uniquement --tenant et prédisez d’abord chaque réponse.
CAMILLE=$(python -m idp token --user usr-camille)INES=$(python -m idp token --user usr-ines)python -m host "Draft a reply to ticket T-40003" --http http://127.0.0.1:8000/mcp --token "$CAMILLE" --tenant larkfieldpython -m host "Draft a reply to ticket T-40003" --http http://127.0.0.1:8000/mcp --token "$CAMILLE" --tenant bramblepython -m host "Draft a reply to ticket T-30002" --http http://127.0.0.1:8000/mcp --token "$INES" --tenant nowhere$CAMILLE = python -m idp token --user usr-camille$INES = python -m idp token --user usr-inespython -m host "Draft a reply to ticket T-40003" --http http://127.0.0.1:8000/mcp --token $CAMILLE --tenant larkfieldpython -m host "Draft a reply to ticket T-40003" --http http://127.0.0.1:8000/mcp --token $CAMILLE --tenant bramblepython -m host "Draft a reply to ticket T-30002" --http http://127.0.0.1:8000/mcp --token $INES --tenant nowhereAfficher les réponses
Camille chez Larkfield : la recherche limitée à l’organisation refuse, et la recherche par mots ne trouve rien.
[server] tool error: Error executing tool get_ticket: not_found: there is no ticket T-40003 in this organization {"ms": 2.2}...I could not use get_ticket: Error executing tool get_ticket: not_found: there is no ticket T-40003 in this organizationI found no policy about this.Camille chez Bramble Books : accès permis, en lecture seule.
Ticket T-40003 (open): Book arrived damaged.From "Damaged or wrong books" (policy://bramble/damaged-or-wrong-books): # Damaged or wrong books If a book arrives damaged, or we sent the wrong book, tell us within 14 days of delivery. Send a …Ines chez nowhere, une organisation inexistante : le même −32003 que chez Larkfield, une vraie organisation où elle n’a aucune adhésion.
[server] protocol error -32003: forbidden: you have no access to this organization {"code": -32003}Le serveur ne dit jamais si une organisation existe. Une personne étrangère à l’organisation n’apprend rien en essayant des noms.
Quand vérifier quoi, et à quel coût
Section intitulée « Quand vérifier quoi, et à quel coût »Vérifiez l’adhésion à chaque requête. Le rôle se trouve dans les données du serveur, pas dans le jeton. Supposons que Grace retire Omar de Larkfield. Son jeton reste valide pendant encore dix minutes au maximum, mais sa prochaine requête peut déjà être refusée. Dans ce projet, le serveur charge data/memberships.csv au démarrage. Un changement exige donc un redémarrage. Un vrai service consulte une base de données à chaque requête, ou un cache qu’il garde à jour. Cette consultation constitue le coût.
Répondez « introuvable » pour les données des autres organisations. La recherche limitée à une organisation est la dernière ligne de défense. Même un bogue dans une vérification précédente ne peut pas montrer un billet de Bramble sur une connexion Larkfield. Le coût : le serveur ne peut pas dire à un utilisateur « ce billet existe ailleurs ». C’est le but.
Gardez la décision sur le serveur. La liste d’autorisation et la confirmation de l’hôte restent importantes pour l’expérience de la personne et les écritures du module 6. Mais n’importe qui peut modifier un hôte, mal le configurer ou le remplacer par curl. Les vérifications du serveur sont celles qui restent en place.
Ce que le serveur n’enregistre pas encore. Le journal de l’exécution n’a aucune ligne pour un refus −32003. Les deux appels refusés de Tomás n’ont laissé aucune trace dans le terminal 2. Un vrai service a besoin de cette trace pour un audit; Limites de ressources et observabilité ajoute des événements structurés.
Erreurs courantes
Section intitulée « Erreurs courantes »Erreur courante
Chaque requête reçoit -32003, même pour Sam
Symptôme : l’hôte affiche protocol error -32003: forbidden: you have no access to this organization (erreur de protocole -32003 : interdit, aucun accès à cette organisation) pour chaque outil, même avec le jeton de Sam.
Cause : l’en-tête d’organisation est absent ou incorrect. Une faute comme --tenant lark, ou un curl sans -H "X-Support-Tenant: larkfield", donne une organisation vide ou inconnue. L’équipe du cours a envoyé un curl sans en-tête et obtenu exactement ce −32003.
Solution : définissez l’organisation dans la configuration de l’hôte : --tenant larkfield pour l’hôte du cours, ou l’en-tête dans curl. Vérifiez l’orthographe dans data/memberships.csv.
Erreur courante
HTTP 403 avec error=« insufficient_scope »
Symptôme :
HTTP/1.1 403 Forbiddenwww-authenticate: Bearer error="insufficient_scope", error_description="Required scope: tickets:read", resource_metadata="http://127.0.0.1:8000/.well-known/oauth-protected-resource/mcp"Cause : le jeton n’a pas l’une des deux portées de lecture. Ici, il a été créé avec --scope knowledge:read. Le serveur exige les deux portées de lecture pour chaque requête. Même une recherche est donc refusée avant MCP.
Solution : demandez les deux portées de lecture, ce que fait python -m idp token par défaut. Si une application en a vraiment besoin de moins, modifiez volontairement la conception du serveur. La tâche autonome du module fait exactement cela.
Nettoyage. Supprimez attempts-log.txt. Gardez les terminaux 1 et 2 en marche pour la prochaine leçon, ou arrêtez-les avec Ctrl+C.
Vérification des connaissances
Section intitulée « Vérification des connaissances »Vérifiez votre compréhension
Expliquez la différence entre l'authentification et l'autorisation dans ce serveur. Nommez l'entrée qui répond à chaque question.
Afficher la réponse
L’authentification répond à la question « Qui appelle? ». Le serveur vérifie le jeton d’accès (signature, émetteur, audience, expiration) et identifie l’utilisateur grâce à sub (identifiant du sujet). L’autorisation répond à la question « Que peut faire cet utilisateur ici? ». Le serveur trouve l’adhésion de l’utilisateur à l’organisation indiquée dans l’en-tête X-Support-Tenant (locataire de soutien). Il prend le rôle dans sa propre table. Ensuite, il vérifie la portée du jeton et cherche l’enregistrement uniquement dans cette organisation. Un jeton valide passe l’authentification, mais l’autorisation peut quand même refuser la requête.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Prédisez le résultat : Omar a un accès en lecture seule chez Larkfield. Avec un jeton valide et les deux portées de lecture, il lit la ressource policy://larkfield/refund-approval-procedure. Que reçoit-il, et quelle vérification détermine ce résultat?
Afficher la réponse
−32602 « Resource not found : policy://larkfield/refund-approval-procedure » (ressource introuvable). Les vérifications du jeton, de l’adhésion et de la portée réussissent. La vérification du rôle masque le document réservé au personnel aux utilisateurs ayant un accès en lecture seule. Le serveur répond comme si le document n’existait pas. Grace, Sam et Camille chez Larkfield (propriétaires ou membres du personnel) peuvent le lire.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Vérification pratique : exécutez python -m scripts.attempts. Combien de tentatives sont autorisées et refusées? Pourquoi Tomás voit-il les outils, mais tous ses appels sont refusés?
Afficher la réponse
48 attempts: 15 allowed, 33 refused on the server. (48 tentatives : 15 autorisées, 33 refusées par le serveur.) Tomás a un jeton valide, donc l’authentification réussit. Dans ce serveur, la découverte ne dépend pas de l’adhésion. Il n’appartient à aucune organisation, donc la vérification de l’adhésion refuse chaque appel avec −32003. Masquer les outils ne protégerait rien; c’est la vérification du serveur qui assure cette protection.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Récapitulatif
- L’authentification prouve qui appelle : le serveur vérifie le jeton. L’autorisation détermine ce que cet utilisateur peut faire dans cette organisation : le serveur vérifie ses propres enregistrements.
- L’appelant se définit par l’utilisateur et les portées du jeton, l’organisation de l’en-tête et le rôle de la table d’adhésion du serveur. Le jeton ne contient ni organisation ni rôle.
- Les vérifications suivent cet ordre pour chaque requête : jeton, adhésion, portée, rôle, recherche limitée à l’organisation. Le premier refus arrête la requête.
- Un enregistrement d’une autre organisation est « introuvable ». Une organisation inconnue reçoit le même code −32003 qu’une organisation sans adhésion.
- Masquer un outil n’est pas une autorisation. Le serveur refuse chaque appel qu’il doit refuser.
Votre projet compte maintenant 63 tests et une table de 48 tentatives réelles. Jusqu’ici, les jetons provenaient d’un raccourci pour les exercices. Ensuite, vous suivrez la méthode officielle permettant à un client MCP d’obtenir un jeton : métadonnées, connexion avec PKCE et audience.
Leçon suivante : Intégration d'OAuth