6 .Nd Interact with Canvas installations
10 suite allows interaction with Canvas installations.
14 programs need to know the url of the Canvas installation they will
15 connect to, and authentication to perform actions as the proper
16 user. For this, two files are used.
19 .It ${XDG_CONFIG_HOME}/nci/site
20 This text file should contain exactly one line, which will be treated
22 .It ${XDG_CONFIG_HOME}/nci/token
23 This text file should contain exactly one line, which will be read as
24 an access token. For details, see
32 authenticate themselves to Canvas by means of
34 The standard way for an application to acquire an access token is to
35 register with Instructure and perform the OAuth2 dance. This, however,
36 is a huge pain in the neck, and it is not entirely clear that all
37 Canvas-using entities have set up OAuth2. Therefore,
39 uses another method: manual user generation of access tokens. In a web
40 browser, while logged into Canvas, go to
42 .D1 Account > Settings > New Access Token
44 and follow the directions to create an access token. It is recommended
45 that you set an expiration date for the token. Write the generated
46 token to ${XDG_CONFIG_HOME}/nci/token. This token should be treated
47 as a password: if a malicious entity acquires the token, tney will be
48 able perform actions with your credentials on Canvas.
51 .Xr nci-course-settings 1
52 .Xr nci-create-assignment 1
53 .Xr nci-create-assignment-group 1
54 .Xr nci-delete-assignment 1
55 .Xr nci-delete-assignment-group 1
56 .Xr nci-edit-assignment 1
57 .Xr nci-edit-assignment-group 1
58 .Xr nci-get-assignment-grades 1
59 .Xr nci-list-assignments 1
60 .Xr nci-list-courses 1
61 .Xr nci-put-assignment-grades 1
63 .An S. Gilles Aq Mt sgilles@math.umd.edu