Skip to content
This repository was archived by the owner on May 23, 2022. It is now read-only.

Commit 0567fa5

Browse files
committed
Wrote some words. Also Brian picked the title "Bearer Token Overview" so let's go with that
1 parent a3abc3b commit 0567fa5

File tree

1 file changed

+15
-10
lines changed

1 file changed

+15
-10
lines changed

docs/security/tokens/overview.md

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,24 @@
11
DateReviewed: 2022-03-10
22
=======
3-
Token Authentication/Authorization Infrastructure (AAI) Overview
4-
================================================================
3+
Bearer Token Overview
4+
=====================
55

6-
Token Authentication/Authorization Infrastructure (AAI) is a security method used
7-
for accessing compute and storage resources.
8-
It was introduced in the OSG 3.5 series as the replacement for X.509 security.
6+
Bearer Tokens are a security method used for accessing compute and storage resources,
7+
introduced as a replacement for X.509.
98

10-
Token AAI is built on the [JSON Web Token](https://jwt.io) standard;
11-
supported implementations are [SciTokens](https://scitokens.org)
12-
[WLCG Tokens](https://github.com/WLCG-AuthZ-WG/common-jwt-profile/blob/master/profile.md).
9+
Bearer Tokens are credential strings in the [JSON Web Token (JWT)](https://jwt.io) format;
10+
a JWT is a small piece of JSON data with a signature that can be verified.
11+
There are two JWT-based token standards that can be used with OSG software: [SciTokens](https://scitokens.org)
12+
and [WLCG Tokens](https://github.com/WLCG-AuthZ-WG/common-jwt-profile/blob/master/profile.md).
1313

14+
X.509 proxies established identity (the DN in your subject) and group membership (VOMS FQANs).
15+
Servers made decisions about access based on those properties.
16+
Tokens also have 'scope' which can restrict the actions that can be done with the token.
17+
For example, a token used for storage access can restrict the files that can be read to a particular directory tree.
18+
Instead of using a single proxy, a job may have multiple tokens.
19+
For example the job could have one token granting it the ability to be run;
20+
it could have a token for read access to an input dataset, and a token for write access to a results directory.
1421

15-
Bearer Token Overview
16-
=====================
1722

1823

1924

0 commit comments

Comments
 (0)