{"id":87648,"date":"2023-06-05T13:10:31","date_gmt":"2023-06-05T17:10:31","guid":{"rendered":"https:\/\/jumpcloud.com\/?post_type=support&#038;p=87648"},"modified":"2023-06-12T19:02:06","modified_gmt":"2023-06-12T23:02:06","slug":"use-system-context-authorization-with-jumpcloud-apis","status":"publish","type":"support","link":"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis","title":{"rendered":"Use System Context Authorization with JumpCloud APIs"},"content":{"rendered":"\n<p>JumpCloud administrators&nbsp;can utilize the System Context API to perform system device auto-scaling with JumpCloud. Actions can range from binding the system associations (direct, group, etc.)&nbsp;to shutdown hooks for destroying associations and deleting the system instance. System Context Authorization also lets JumpCloud administrators automate the binding and removal of users to JumpCloud-managed, UNIX-based systems.<\/p>\n\n\n\n<div class=\"wp-block-cgb-notification-card-wysiwyg notification-card note\"><div class=\"notification-card-content\"><div class=\"notification-card-icon\"><p><img decoding=\"async\" src=\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/note-icon.png\"\/><\/p><\/div><div class=\"notification-card-copy is-type-body-default\"><div><strong class=\"notification-card-type\">Note:<\/strong> \n<p>Systems that have been automatically enrolled using&nbsp;Automated Device Enrollment (ADE), MDM enrollment, or systems enrolled using the User Portal install are not eligible to use the System Context API. Systems enrolled in these ways are unable to use the System Context API to prevent unauthorized access to system groups and resources. If a script that utilizes the System Context API is invoked on a system enrolled in such a way, it will error with an&nbsp;unauthorized&nbsp;message.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n<ul>\n<li>Learn how to use System Context Authorization in our\u00a0<a href=\"https:\/\/docs.jumpcloud.com\/api\/index.html\" target=\"_blank\" rel=\"noreferrer noopener\">System Context Authorization API doc<\/a>.\u00a0<\/li>\n\n\n\n<li>Administrators can also find links to&nbsp;<a target=\"_blank\" href=\"https:\/\/github.com\/TheJumpCloud\/support\/tree\/master\/scripts\/api\/system_context\" rel=\"noreferrer noopener\">sample scripts on GitHub<\/a>.<\/li>\n<\/ul>\n\n\n\n<p>JumpCloud administrators&nbsp;can authenticate to a subset of endpoints using System Context Authorization without needing to authenticate to the JumpCloud API with&nbsp;an API key. The endpoints include the following:<\/p>\n\n\n\n<ul>\n<li>A system may fetch, alter, and delete metadata about itself, including manipulating a system&#8217;s Group and Systemuser associations\n<ul>\n<li><code>\/api\/systems\/{system_id}&nbsp;|&nbsp;GET&nbsp;PUT<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>A system may delete itself from your JumpCloud organization\n<ul>\n<li><code>\/api\/systems\/{system_id}&nbsp;|&nbsp;DELETE<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>A system may fetch its direct resource associations under v2 (Groups)\n<ul>\n<li><code>\/api\/v2\/systems\/{system_id}\/memberof&nbsp;|&nbsp;GET<\/code><\/li>\n\n\n\n<li><code>\/api\/v2\/systems\/{system_id}\/associations&nbsp;|&nbsp;GET<\/code><\/li>\n\n\n\n<li><code>\/api\/v2\/systems\/{system_id}\/users&nbsp;|&nbsp;GET<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>A system may alter its direct resource associations under v2 (Groups)\n<ul>\n<li><code>\/api\/v2\/systems\/{system_id}\/associations&nbsp;|&nbsp;POST<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>A system may alter its System Group associations\n<ul>\n<li><code>\/api\/v2\/systemgroups\/{systemgroup_id}\/members&nbsp;|&nbsp;POST<\/code>\n<ul>\n<li><strong>Note<\/strong>:&nbsp;If a system attempts to alter the system group membership of a different system, the request will be rejected.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>JumpCloud administrators&nbsp;can utilize the System Context API to perform system device auto-scaling with JumpCloud. Actions can range from binding the [&hellip;]<\/p>\n","protected":false},"author":206,"featured_media":0,"template":"","meta":{"_acf_changed":false,"_oasis_is_in_workflow":0,"_oasis_original":0,"_oasis_task_priority":"","inline_featured_image":false,"footnotes":""},"support_category":[2917,2856],"support_tag":[],"coauthors":[2842],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v22.9 (Yoast SEO v22.9) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Use System Context Authorization with JumpCloud APIs - JumpCloud<\/title>\n<meta name=\"description\" content=\"Learn how to use the System Context API to perform system device auto-scaling.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Use System Context Authorization with JumpCloud APIs\" \/>\n<meta property=\"og:description\" content=\"Learn how to use the System Context API to perform system device auto-scaling.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis\" \/>\n<meta property=\"og:site_name\" content=\"JumpCloud\" \/>\n<meta property=\"article:modified_time\" content=\"2023-06-12T23:02:06+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/202405-MISC-JumpCloudHelpCenter-SiteDisplay-min-2.png\" \/>\n\t<meta property=\"og:image:width\" content=\"890\" \/>\n\t<meta property=\"og:image:height\" content=\"525\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"pamkellman\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis\",\"url\":\"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis\",\"name\":\"Use System Context Authorization with JumpCloud APIs - JumpCloud\",\"isPartOf\":{\"@id\":\"https:\/\/jumpcloud.com\/#website\"},\"datePublished\":\"2023-06-05T17:10:31+00:00\",\"dateModified\":\"2023-06-12T23:02:06+00:00\",\"description\":\"Learn how to use the System Context API to perform system device auto-scaling.\",\"breadcrumb\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/jumpcloud.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Support\",\"item\":\"https:\/\/jumpcloud.com\/support\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Use System Context Authorization with JumpCloud APIs\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/jumpcloud.com\/#website\",\"url\":\"https:\/\/jumpcloud.com\/\",\"name\":\"JumpCloud\",\"description\":\"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.\",\"publisher\":{\"@id\":\"https:\/\/jumpcloud.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/jumpcloud.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/jumpcloud.com\/#organization\",\"name\":\"JumpCloud\",\"url\":\"https:\/\/jumpcloud.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"contentUrl\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"width\":598,\"height\":101,\"caption\":\"JumpCloud\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Use System Context Authorization with JumpCloud APIs - JumpCloud","description":"Learn how to use the System Context API to perform system device auto-scaling.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis","og_locale":"en_US","og_type":"article","og_title":"Use System Context Authorization with JumpCloud APIs","og_description":"Learn how to use the System Context API to perform system device auto-scaling.","og_url":"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis","og_site_name":"JumpCloud","article_modified_time":"2023-06-12T23:02:06+00:00","og_image":[{"width":890,"height":525,"url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/202405-MISC-JumpCloudHelpCenter-SiteDisplay-min-2.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes","Written by":"pamkellman"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis","url":"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis","name":"Use System Context Authorization with JumpCloud APIs - JumpCloud","isPartOf":{"@id":"https:\/\/jumpcloud.com\/#website"},"datePublished":"2023-06-05T17:10:31+00:00","dateModified":"2023-06-12T23:02:06+00:00","description":"Learn how to use the System Context API to perform system device auto-scaling.","breadcrumb":{"@id":"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/jumpcloud.com\/support\/use-system-context-authorization-with-jumpcloud-apis#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/jumpcloud.com\/"},{"@type":"ListItem","position":2,"name":"Support","item":"https:\/\/jumpcloud.com\/support"},{"@type":"ListItem","position":3,"name":"Use System Context Authorization with JumpCloud APIs"}]},{"@type":"WebSite","@id":"https:\/\/jumpcloud.com\/#website","url":"https:\/\/jumpcloud.com\/","name":"JumpCloud","description":"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.","publisher":{"@id":"https:\/\/jumpcloud.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/jumpcloud.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/jumpcloud.com\/#organization","name":"JumpCloud","url":"https:\/\/jumpcloud.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/","url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","contentUrl":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","width":598,"height":101,"caption":"JumpCloud"},"image":{"@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/87648"}],"collection":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support"}],"about":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/types\/support"}],"author":[{"embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/users\/206"}],"version-history":[{"count":3,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/87648\/revisions"}],"predecessor-version":[{"id":90796,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/87648\/revisions\/90796"}],"wp:attachment":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/media?parent=87648"}],"wp:term":[{"taxonomy":"support_category","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_category?post=87648"},{"taxonomy":"support_tag","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_tag?post=87648"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/coauthors?post=87648"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}