Mercurial > hg > orthanc-book

comparison Sphinx/source/plugins/authorization.rst @ 1004:17bf6fafb884

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
added links to uclouvain
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 20 Dec 2023 08:12:21 +0100
parents 05b106383b2a
children 7fbd7a6a1d56
comparison
equal deleted inserted replaced
1003:5c7838bfb18d 1004:17bf6fafb884
4 Advanced authorization plugin 4 Advanced authorization plugin
5 ============================= 5 =============================
6 6
7 .. contents:: 7 .. contents::
8 8
9 This **official plugin by Osimis** extends Orthanc with an advanced 9 This **official plugin** extends Orthanc with an advanced
10 authorization mechanism. For each incoming REST request to some URI, 10 authorization mechanism. For each incoming REST request to some URI,
11 the plugin will query a Web service to know whether the access is 11 the plugin will query a Web service to know whether the access is
12 granted to the user. If access is not granted, the HTTP status code is 12 granted to the user. If access is not granted, the HTTP status code is
13 set to ``403`` (Forbidden). 13 set to ``403`` (Forbidden).
14 14
396 .. _orthanc-explorer-authorization: 396 .. _orthanc-explorer-authorization:
397 397
398 Integration with the Orthanc Explorer 398 Integration with the Orthanc Explorer
399 ------------------------------------- 399 -------------------------------------
400 400
401 Starting from Orthanc 1.5.8, you can pass authorization tokens in the url 401 Starting from Orthanc 1.5.8, you can pass authorization tokens in the
402 search params when opening the Orthanc explorer i.e. 402 url search params when opening the Orthanc explorer, i.e.
403 http://localhost:8042/app/explorer.html?token=1234. This token will be 403 ``http://localhost:8042/app/explorer.html?token=1234``. This token
404 included as an HTTP header in every request sent to the Orthanc Rest API. 404 will be included as an HTTP header in every request sent to the
405 It will also be included in the url search params when opening the Orthanc 405 Orthanc Rest API. It will also be included in the URL search params
406 or Osimis viewer. 406 when opening the Orthanc or :ref:`Osimis Web viewer
407 <osimis_webviewer>`.
407 408
408 Only 3 tokens name will be recognized and forwarded: ``token``, ``auth-token`` 409 Only 3 tokens name will be recognized and forwarded: ``token``, ``auth-token``
409 and ``authorization``. 410 and ``authorization``.
410 411
411 Please note that the Orthanc Explorer has not been designed to handle 412 Please note that the Orthanc Explorer has not been designed to handle