{"_id":"56a83c6ded52570d0001a1e8","__v":20,"parentDoc":null,"version":{"_id":"56a83b989ec7660d002e07c1","project":"56a83b979ec7660d002e07be","__v":9,"createdAt":"2016-01-27T03:38:00.333Z","releaseDate":"2016-01-27T03:38:00.333Z","categories":["56a83b989ec7660d002e07c2","56a83c282036420d002d21e1","56a96de8f834950d0037b35a","56a9706013a69a0d00a778c3","56a970ec2d8fd90d0036eec7","56a971a62bb3910d000ee934","56a973372d8fd90d0036eece","56a978dc2bb3910d000ee93f","571d5ae118b3c10e003e55cd"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"Beta","version_clean":"1.0.0","version":"1.0"},"user":"56a83a6070a9440d00ef5ef8","category":{"_id":"56a83b989ec7660d002e07c2","pages":["56a83b999ec7660d002e07c4","56a83c1011d0390d00a3d107","56a83c6ded52570d0001a1e8","56a83cba70a9440d00ef5ef9","56a83f1470a9440d00ef5efb","56a83f5b70a9440d00ef5efd","56a97284f834950d0037b35e","56a973312bb3910d000ee937"],"project":"56a83b979ec7660d002e07be","version":"56a83b989ec7660d002e07c1","__v":8,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-27T03:38:00.961Z","from_sync":false,"order":1,"slug":"documentation","title":"General"},"project":"56a83b979ec7660d002e07be","githubsync":"","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-27T03:41:33.475Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"<div class=\"corner-ribbon top-left sticky blue\"><a style=\"color: white;\" href=\"https://pathfinder.readme.io/blog/pathfinder-now-in-public-beta\">Public Beta!</a></div>\n\nA Pathfinder application is a set of clusters that share their routing configuration and authentication. Unless you are developing multiple applications, you likely will not need multiple Pathfinder applications.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Registering an application\"\n}\n[/block]\nBefore integrating your app with Pathfinder, you must register an application. This can be done through the dashboard at https://thepathfinder.xyz. All that you need is a name, which does not need to be unique.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/csxKv8inSceOU0bJgvXo_Screen%20Shot%202016-04-24%20at%207.50.55%20PM.png\",\n        \"Screen Shot 2016-04-24 at 7.50.55 PM.png\",\n        \"340\",\n        \"197\",\n        \"#5bba5b\",\n        \"\"\n      ],\n      \"border\": false,\n      \"caption\": \"Figure 1: Could it be easier?\"\n    }\n  ]\n}\n[/block]\nPathfinder will generate an application id for your new application which is its unique identifier.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Configuring an application\"\n}\n[/block]\nAfter you've created an application, you should see a new application card on the dashboard. The Identifier field is the unique Pathfinder application identifier used by the SDKs to identify your application.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/vDgcTdHmTcSBp3sNykv5_Screen%20Shot%202016-04-24%20at%207.57.32%20PM.png\",\n        \"Screen Shot 2016-04-24 at 7.57.32 PM.png\",\n        \"334\",\n        \"227\",\n        \"#3e6c64\",\n        \"\"\n      ],\n      \"caption\": \"Figure 2: A Pathfinder application card\"\n    }\n  ]\n}\n[/block]\nIf you plan to use custom authentication instead of Pathfinder hosted authentication, you will need to generate a new key. By clicking on the \"Generate new key\" link, Pathfinder will generate a public/private RSA key pair for your application and your browser will download the private key. At this time Pathfinder does not support uploading your own key.\n\nYou can delete an application by clicking on the <i class=\"fa fa-trash-o\" aria-hidden=\"true\"></i>. Deleting an application cannot be undone and has undefined behavior for vehicles and transports currently using your application.","excerpt":"","slug":"registering-an-application","type":"basic","title":"Applications"}
<div class="corner-ribbon top-left sticky blue"><a style="color: white;" href="https://pathfinder.readme.io/blog/pathfinder-now-in-public-beta">Public Beta!</a></div> A Pathfinder application is a set of clusters that share their routing configuration and authentication. Unless you are developing multiple applications, you likely will not need multiple Pathfinder applications. [block:api-header] { "type": "basic", "title": "Registering an application" } [/block] Before integrating your app with Pathfinder, you must register an application. This can be done through the dashboard at https://thepathfinder.xyz. All that you need is a name, which does not need to be unique. [block:image] { "images": [ { "image": [ "https://files.readme.io/csxKv8inSceOU0bJgvXo_Screen%20Shot%202016-04-24%20at%207.50.55%20PM.png", "Screen Shot 2016-04-24 at 7.50.55 PM.png", "340", "197", "#5bba5b", "" ], "border": false, "caption": "Figure 1: Could it be easier?" } ] } [/block] Pathfinder will generate an application id for your new application which is its unique identifier. [block:api-header] { "type": "basic", "title": "Configuring an application" } [/block] After you've created an application, you should see a new application card on the dashboard. The Identifier field is the unique Pathfinder application identifier used by the SDKs to identify your application. [block:image] { "images": [ { "image": [ "https://files.readme.io/vDgcTdHmTcSBp3sNykv5_Screen%20Shot%202016-04-24%20at%207.57.32%20PM.png", "Screen Shot 2016-04-24 at 7.57.32 PM.png", "334", "227", "#3e6c64", "" ], "caption": "Figure 2: A Pathfinder application card" } ] } [/block] If you plan to use custom authentication instead of Pathfinder hosted authentication, you will need to generate a new key. By clicking on the "Generate new key" link, Pathfinder will generate a public/private RSA key pair for your application and your browser will download the private key. At this time Pathfinder does not support uploading your own key. You can delete an application by clicking on the <i class="fa fa-trash-o" aria-hidden="true"></i>. Deleting an application cannot be undone and has undefined behavior for vehicles and transports currently using your application.