{"pageModel":{"attributes":{"id":"","name":"122511.dita","viewName":"DitaDetail"},"elements":{"ditaContent":{"name":"DITAContent","value":"<article id=\"api-keys\" class=\"topic concept\">\r\n<h1 class=\"title topictitle1\">API Keys and URLs</h1>\r\n<div class=\"body conbody\">\r\n<p class=\"p\">AI Defense uses API keys to authenticate and secure communication between your applications and its services. You must generate all API keys in the AI Defense UI. Generate the type of key that corresponds to the API you will use:</p>\r\n<ul class=\"ul\">\r\n<li class=\"li\">\r\n<p class=\"p\">For the AI Defense Management API, generate a  <a data-scope=\"local\" target=\"\" href=\"docs/ai-def/user/122511.dita#aidef-mgmt-api-key-gen\" title=\"\">Management API key</a>.</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\">For the AI Defense Inspection API, generate an  <a data-scope=\"local\" target=\"\" href=\"docs/ai-def/user/122511.dita#aidef-inspect-api-key-gen\" title=\"\">Inspection API key</a>.</p>\r\n</li>\r\n</ul>\r\n<table class=\"olh_note\" border=\"0\" role=\"note\">\r\n<tbody>\r\n<tr>\r\n<td width=\"5%\" class=\"olh_note\" role=\"heading\" border=\"0\" valign=\"top\">\r\n<img src=\"https://www.cisco.com/c/dam/en/us/td/i/esp/icons/icon-warning.svg\">\r\n<br> </td>\r\n<td border=\"0\" class=\"olh_note\">\r\n<div class=\"note__content\">Inspection API keys and Management API keys are not interchangeable.</div>\r\n</td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n<section id=\"aidef-mgmt-api-key-gen\" class=\"section\">\r\n<h2 class=\"title sectiontitle\">\r\n<strong class=\"ph b\">Generate an API Key for the Management API</strong>\r\n</h2>\r\n<p class=\"p\">To use the  <a data-scope=\"external\" target=\"_blank\" href=\"https://developer.cisco.com/docs/ai-defense-management/\" title=\"\">AI Defense Management API</a>, you must generate an API key through the AI Defense Dashboard. Follow these steps:</p>\r\n<ol class=\"ol\">\r\n<li class=\"li\">\r\n<p class=\"p\">In AI Defense, click <strong class=\"ph b\">Administration</strong>.</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\">In the Administration page, click <strong class=\"ph b\">API Keys</strong> and click <strong class=\"ph b\">Create an API key</strong>.</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\">Specify a <strong class=\"ph b\">Name</strong> for the key</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\">Specify its <strong class=\"ph b\">Expire on</strong> date or set it to <strong class=\"ph b\">Never Expire</strong>.</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\">Click <strong class=\"ph b\">Create</strong>.</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\">Copy this key and save it to a secure location. You will not be able to see the token again after you close this page. You will use this token to make requests of the AI Defense Management API. (You cannot use this key for the AI Defense Inspection API.</p>\r\n</li>\r\n</ol>\r\n</section>\r\n<section id=\"section_g5w_dbj_xhc\" class=\"section\">\r\n<h2 class=\"title sectiontitle\">Base URLs for the Management API</h2>\r\n<p class=\"p\">Use the appropriate regional URL to access the Management API:</p>\r\n<ul id=\"ul_chh_fbj_xhc\" class=\"ul\">\r\n<li class=\"li\">\r\n<p class=\"p\"> <a data-scope=\"external\" target=\"_blank\" href=\"https://api.us.security.cisco.com\" title=\"\">https://api.us.security.cisco.com</a> for the us-west-2 region</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\"> <a data-scope=\"external\" target=\"_blank\" href=\"https://api.apj.security.cisco.com\" title=\"\">https://api.apj.security.cisco.com</a> for the ap-ne-1 region</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\"> <a data-scope=\"external\" target=\"_blank\" href=\"https://api.eu.security.cisco.com\" title=\"\">https://api.eu.security.cisco.com</a> for the eu-central-1 region</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\"> <a data-scope=\"external\" target=\"_blank\" href=\"https://api.uae.security.cisco.com\" title=\"\">https://api.uae.security.cisco.com</a> for the mece (UAE) region</p>\r\n</li>\r\n</ul>\r\n<p class=\"p\">\r\n<strong class=\"ph b\">Next step</strong>: See  <a data-scope=\"external\" target=\"_blank\" href=\"https://developer.cisco.com/docs/ai-defense-management/authentication/#authenticate-with-your-api-key\" title=\"\">Authenticate with Your API Key</a> to learn how to connect to the API.</p>\r\n</section>\r\n<section id=\"aidef-inspect-api-key-gen\" class=\"section\">\r\n<h2 class=\"title sectiontitle\">\r\n<strong class=\"ph b\">Generate an API Key for the Inspection API</strong>\r\n</h2>\r\n<p class=\"p\">To use the  <a data-scope=\"external\" target=\"_blank\" href=\"https://developer.cisco.com/docs/ai-defense-inspection/introduction/\" title=\"\">AI Defense Inspection API</a>, you must create an Application and a Connection, and create the Inspection API key in the context of the Connection. Follow the steps in  <a data-scope=\"local\" target=\"\" href=\"docs/ai-def/user/105486.dita\" title=\"\">Set up Runtime for the Inspection API</a>.</p>\r\n</section>\r\n<section id=\"section_wnm_jbj_xhc\" class=\"section\">\r\n<h2 class=\"title sectiontitle\">Base URLs for the Inspection API</h2>\r\n<p class=\"p\">Use the appropriate regional URL to access the Inspection API:</p>\r\n<ul id=\"ul_yft_lbj_xhc\" class=\"ul\">\r\n<li class=\"li\">\r\n<p class=\"p\"> <a data-scope=\"external\" target=\"_blank\" href=\"https://us.api.inspect.aidefense.security.cisco.com\" title=\"\">https://us.api.inspect.aidefense.security.cisco.com</a> for the us-west-2 region</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\"> <a data-scope=\"external\" target=\"_blank\" href=\"https://ap.api.inspect.aidefense.security.cisco.com\" title=\"\">https://ap.api.inspect.aidefense.security.cisco.com</a> for the ap-ne-1 region</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\"> <a data-scope=\"external\" target=\"_blank\" href=\"https://eu.api.inspect.aidefense.security.cisco.com\" title=\"\">https://eu.api.inspect.aidefense.security.cisco.com</a> for the eu-central-1 region</p>\r\n</li>\r\n<li class=\"li\">\r\n<p class=\"p\"> <a data-scope=\"external\" target=\"_blank\" href=\"http://uae.api.inspect.aidefense.security.cisco.com\" title=\"\">https://uae.api.inspect.aidefense.security.cisco.com</a> for the mece (UAE) region</p>\r\n</li>\r\n</ul>\r\n<p class=\"p\">\r\n<strong class=\"ph b\">Next step</strong>: See  <a data-scope=\"external\" target=\"_blank\" href=\"https://developer.cisco.com/docs/ai-defense-management/authentication/#authenticate-with-your-api-key\" title=\"\">Authenticate with Your API Key</a> to learn how to connect to the API.</p>\r\n</section>\r\n</div>\r\n</article>\r\n","ditaVal":"","format":"html"},"bookTitle":{"value":""},"shortDescription":{"value":""}}},"parameters":{"appId":"SccAiDefense","topicAlias":"APIKeys"}}