MedCo Technical Documentation
GithubDocker HubMedCoLDS
v3.0.0
v3.0.0
  • Home
  • Releases
  • For System Administrators
    • Requirements
    • Deployment
      • Local Test Deployment
      • Network Deployment
      • Configuration
        • Passwords
        • Keycloak
        • Setting Authorizations
        • HTTPS Configuration
        • Configuring SwitchAAI Authentication
    • Data Loading
      • Synthetic SPO Data
      • v0 (Genomic Data)
      • v1 (I2B2 Demodata)
    • Command-Line Interface (CLI)
    • Network Architecture
    • Common Problems
  • For Developers
    • Local Development Deployment
    • System Architecture
    • Description of the default test data
    • Database
    • Live Demo
    • Release a new version
  • For users
    • MedCo Live Demo Tutorial
Powered by GitBook
On this page
  • Authorizations
  • REST API Authorizations
  • Explore Query Authorizations

Was this helpful?

Export as PDF
  1. For System Administrators
  2. Deployment
  3. Configuration

Setting Authorizations

This page guide you on how to set authorizations to users through Keycloak.

PreviousKeycloakNextHTTPS Configuration

Last updated 3 years ago

Was this helpful?

You will find below the documentation for each authorization available in MedCo.

Authorizations

REST API Authorizations

Those authorizations allow the user to interact with API endpoints of the MedCo connector.

The minimum set of authorizations needed for users to use MedCo is the following:

  • medco-network

  • medco-explore

  • medco-genomic-annotations

medco-network

This covers the calls related to the network metadata: list of nodes, keys, URLs, etc.

medco-explore

This covers the calls related to the building and requesting of explore queries and cohort saving. Note that an additional authorization among the is needed to be able to make explore queries.

medco-genomic-annotations

This covers the genomic annotations auto-completion and the querying of genomic variants.

medco-survival-analysis

This covers the calls needed for requesting computations of survival curves.

Explore Query Authorizations

Those authorizations set the types of result users will be able to get when making an explore query.

Those authorizations are ordered according to their precedence. This means that if a user has several of them, the authorization with the highest level will be selected.

  1. patient_list: exact counts and list of patient identifiers from all sites

  2. count_per_site: exact counts from all sites

  3. count_per_site_obfuscated: obfuscated counts from all sites

  4. count_per_site_shuffled: exact counts from all sites, but without knowing which count came from which site

  5. count_per_site_shuffled_obfuscated: obfuscated counts from all sites, but without knowing which count came from which site

  6. count_global: exact aggregated global count

  7. count_global_obfuscated: obfuscated (at the site level) aggregated global count

explore query authorizations
Follow this section to know how to modify those authorizations for your users.