|
| 1 | +DateReviewed: 2022-03-10 |
| 2 | + |
| 3 | +Bearer Token Overview |
| 4 | +===================== |
| 5 | + |
| 6 | + |
| 7 | + |
| 8 | + |
| 9 | +Validating Tokens in Pilot Jobs |
| 10 | +------------------------------- |
| 11 | + |
| 12 | +If an incoming (pre-routed) pilot on a CE has a token, it will have the following classad attributes: |
| 13 | + |
| 14 | +| Attribute | Meaning | |
| 15 | +|------------------|-------------------------------------| |
| 16 | +| AuthTokenId | A UUID of the token | |
| 17 | +| AuthTokenIssuer | The URL of the issuer of the token | |
| 18 | +| AuthTokenScopes | Any scope restrictions on the token | |
| 19 | +| AuthTokenSubject | The 'sub' field of the token | |
| 20 | + |
| 21 | +(A pre-routed job is a job without `RoutedJob=True` in its classad.) |
| 22 | + |
| 23 | +!!! note |
| 24 | + A job may have both a token and an X.509 proxy. |
| 25 | + Presence of any `x509*` attributes does not indicate the absence of a token. |
| 26 | + |
| 27 | +To see which authentication method was used for a job: |
| 28 | +- Examine the `/var/log/condor-ce/AuditLog*` files. |
| 29 | +- Find a line saying `Submitting new job <JOBID>` (where `<JOBID>` is a job ID like `21249.0`). |
| 30 | + The line before that should say what authentication method was used. |
| 31 | + - Authentication via a token will say `AuthMethod=SCITOKENS`. |
| 32 | + - Authentication via a proxy will say `AuthMethod=GSI`. |
| 33 | + |
| 34 | +See the [upstream documentation](https://htcondor.com/htcondor-ce/v5/troubleshooting/common-issues/#jobs-fail-to-submit-verify-scitoken-contents) |
| 35 | +for more details. |
| 36 | + |
| 37 | +Collaboration support |
| 38 | +--------------------- |
| 39 | + |
| 40 | +!!! info "Verify support with collaborations" |
| 41 | + The tables of collaborations below are updated as frequently as possible. |
| 42 | + If a collaboration you support is listed as not supporting tokens or WebDav, please contact your collaboration |
| 43 | + directly to verify that this information is up-to-date. |
| 44 | + |
| 45 | +### Pilot job submission ### |
| 46 | + |
| 47 | +These are the collaborations that support or partially support using tokens for pilot submission: |
| 48 | + |
| 49 | +| Collaboration | Supports Bearer Tokens | |
| 50 | +|:--------------|------------------------| |
| 51 | +| ATLAS | Undergoing testing | |
| 52 | +| CLAS12 | Undergoing testing | |
| 53 | +| CMS | Undergoing testing | |
| 54 | +| EIC | Undergoing testing | |
| 55 | +| GLOW | Yes | |
| 56 | +| GlueX | Undergoing testing | |
| 57 | +| IceCube | Undergoing testing | |
| 58 | +| LIGO | Undergoing testing | |
| 59 | +| OSG | Yes | |
| 60 | + |
| 61 | +Until all of the collaborations you support are using tokens in production, your CE should remain on OSG 3.5, |
| 62 | +with the 3.5-upcoming repositories enabled. |
| 63 | + |
| 64 | +### WebDAV/XRootD File transfer ### |
| 65 | + |
| 66 | +The following collaborations support support file transfer using WebDAV or XRootD: |
| 67 | + |
| 68 | +| Collaboration | Supports WebDAV or XRootD | |
| 69 | +|:--------------|---------------------------| |
| 70 | +| ATLAS | Yes | |
| 71 | +| CMS | Yes | |
| 72 | +| CLAS12 | Yes | |
| 73 | +| EIC | N/A | |
| 74 | +| GLOW | N/A | |
| 75 | +| GlueX | No | |
| 76 | +| IceCube | Undergoing testing | |
| 77 | +| LIGO | Undergoing testing | |
| 78 | +| OSG | N/A | |
0 commit comments