File: condor_test_token.rst

package info (click to toggle)
condor 23.9.6%2Bdfsg-2.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 60,012 kB
  • sloc: cpp: 528,272; perl: 87,066; python: 42,650; ansic: 29,558; sh: 11,271; javascript: 3,479; ada: 2,319; java: 619; makefile: 615; xml: 613; awk: 268; yacc: 78; fortran: 54; csh: 24
file content (70 lines) | stat: -rw-r--r-- 1,955 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70


*condor_test_token*
===================

Create a short-lived SciToken to authenticate with local HTCondor daemons
:index:`condor_test_token<single: condor_test_token; HTCondor commands>`
:index:`condor_test_token command`

Synopsis
--------

**condor_test_token** [**--help**]

**condor_test_token**
**--issuer** *issuer-url*
**--scope** *scopes*
[**--subject** *subject*]
[**--lifetime** *lifetime*]
[**--audience** *audience*]
[**--cache** *cache-location*]

Description
-----------

*condor_test_token* generates a temporary signing key, adds it to the
local SciTokens cache for the given issuer, creates a short-lived
token signed by the key, and prints the token to stdout.
Local HTCondor daemons will treat this token like any reguluar token
generated by the given issuer for a short period of time (one hour).

If the HTCondor daemons were started as root, then the tool must be
run as the condor user.

Options
-------

 **--help**
    Display usage information
 **--issuer** *issuer-url*
    Specify the issuer to impersonate
 **--scope** *scopes*
    Specify the scope claim for the token
 **--subject** *subject*
    specify the sub claim for the token (default is no sub claim)
 **--lifetime** *lifetime*
    Specify the lifetime of the token in seconds (default 1 hour)
 **--audience** *audience*
    Specify the aud claim for the token (default is no aud claim)
 **--cache** *cache-location*
    Specify the SciTokens cache location (default is to find cache via
    HTCondor configuration files)

Examples
--------

To create a SciToken with WRITE-level access for user Alice that
appears to be issued by the SciTokens demo issuer:

.. code-block:: console

    $ condor_test_token --issuer https://demo.scitokens.org \
        --scope condor:/WRITE --sub alice@foo.org --aud ANY

Exit Status
-----------

*condor_test_token* will exit with a status value of 0 (zero) upon
success, and it will exit with the value 1 (one) upon failure.