{"id":668,"date":"2020-01-14T17:32:25","date_gmt":"2020-01-14T20:32:25","guid":{"rendered":"https:\/\/micheladrianomedeiros.com.br\/blog\/?p=668"},"modified":"2020-01-14T17:34:00","modified_gmt":"2020-01-14T20:34:00","slug":"construindo-ferramentas-com-github-4","status":"publish","type":"post","link":"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-4\/","title":{"rendered":"Construindo Ferramentas com GitHub #4"},"content":{"rendered":"\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_84 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-4\/#OAuth\" >OAuth<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-4'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/micheladrianomedeiros.com.br\/blog\/construindo-ferramentas-com-github-4\/#_Escopos_acoes_especificadas_vinculadas_a_autenticacao_de_tokens\" >&nbsp;Escopos: a\u00e7\u00f5es especificadas vinculadas a autentica\u00e7\u00e3o\nde tokens<\/a><\/li><\/ul><\/nav><\/div>\n<h4 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"OAuth\"><\/span><strong>OAuth<\/strong><span class=\"ez-toc-section-end\"><\/span><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">OAuth \u00e9 um mecanismo de\nautentica\u00e7\u00e3o onde tokens s\u00e3o amarrados em funcionalidades ou clientes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Em outras palavras, voc\u00ea pode\nespecificar quais recursos de um servi\u00e7o voc\u00ea quer permitir a um token do OAuth\nque esteja ligado a ele, e voc\u00ea pode emitir v\u00e1rios tokens e amarr\u00e1-los a espec\u00edficos\nclientes: celular, laptop, smart watch ou a um dispositivo da Internet das\nCoisas como uma torradeira.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">E o mais importante \u00e9 que voc\u00ea\npode revogar tokens sem impactar outros tokens.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A principal desvantagem do OAuth\ntokens \u00e9 que ele introduz um n\u00edvel de complexidade que voc\u00ea pode n\u00e3o estar\nacostumado se voc\u00ea apenas utiliza o HTTP Basic.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Os requests do HTTP Basic\ngeralmente apenas requerem adicionar um extra header para o HTTP request, ou um\nflag extra para o cliente como faz a ferramenta cURL.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">OAuth resolve os problemas\napenas vinculando tokens aos escopos (configurando funcionalidades dentro de um\nweb service) e emitindo v\u00e1rios tokens que forem preciso para m\u00faltiplos\nclientes.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"_Escopos_acoes_especificadas_vinculadas_a_autenticacao_de_tokens\"><\/span>&nbsp;<strong>Escopos: a\u00e7\u00f5es especificadas vinculadas a autentica\u00e7\u00e3o\nde tokens<\/strong><span class=\"ez-toc-section-end\"><\/span><\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Quando voc\u00ea gera um token\nOAuth, voc\u00ea especifica o direito de acesso que voc\u00ea configurou.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Apesar de nossos exemplos\ncriar um token utilizando o HTTP Basic, uma vez que voc\u00ea tenha o token, voc\u00ea\nn\u00e3o precisa mais utilizar o HTTP Basic nos pr\u00f3ximos requests.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Se esse token \u00e9 devidamente\nemitido, o token do OAuth ir\u00e1 ter permiss\u00f5es para ler e escrever no reposit\u00f3rio\np\u00fablico do usu\u00e1rio.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Vamos fazer um comando no cURL\nusando o HTTP Basic para iniciar o processo do token request.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Digite o comando curl -u\nblackzig -d &#8220;{\\&#8221;scopes\\&#8221;:[\\&#8221;public_repo\\&#8221;],\n\\&#8221;note\\&#8221;: \\&#8221;Nova Autorizacao\\&#8221;}&#8221; <a href=\"https:\/\/api.github.com\/authorizations\">https:\/\/api.github.com\/authorizations<\/a><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Em note, n\u00e3o coloque nenhuma\nacentua\u00e7\u00e3o que vai dar erro.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Enter host password for user &#8216;blackzig&#8217;:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">{<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp;\n&#8220;id&#8221;: 372271144,<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp;\n&#8220;url&#8221;:\n&#8220;https:\/\/api.github.com\/authorizations\/372271144&#8221;,<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; &#8220;app&#8221;:\n{<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp;&nbsp;&nbsp; &#8220;name&#8221;: &#8220;Nova\nAutorizacao&#8221;,<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp;&nbsp;&nbsp; &#8220;url&#8221;:\n&#8220;https:\/\/developer.github.com\/v3\/oauth_authorizations\/&#8221;,<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp;&nbsp;&nbsp; &#8220;client_id&#8221;:\n&#8220;00000000000000000000&#8221;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp; },<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">&nbsp;\n&#8220;token&#8221;: &#8220;5f46d18e03b1baac156bc465e5c09499d8cf1227&#8221;,<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u2026<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">}<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A resposta JSON gerada, tem um\ntoken que voc\u00ea pode extrair e usar para aplica\u00e7\u00e3o que precisa acessar a API do\nGitHub.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para usar esse token, voc\u00ea especifica\no token dentro do header de autoriza\u00e7\u00e3o: curl -H &#8220;Authorization:\ntoken abcdef87654321&#8221; &#8230;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Escopos esclarecem como um\nservi\u00e7o ou aplica\u00e7\u00e3o ir\u00e1 usar os dados dentro do GitHub API.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Isto facilita a auditoria de\ncomo voc\u00ea est\u00e1 usando a informa\u00e7\u00e3o se for um token que est\u00e1 ligado ao seu uso\npessoal.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Mas, o mais importante, isto\nfornece uma claridade e prote\u00e7\u00e3o para aplica\u00e7\u00f5es de terceiro que desejam\nacessar suas informa\u00e7\u00f5es: voc\u00ea pode assegurar a limita\u00e7\u00e3o da aplica\u00e7\u00e3o e os\ndados que ser\u00e3o acessados e voc\u00ea pode revogar o acesso facilmente.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>OAuth OAuth \u00e9 um mecanismo de autentica\u00e7\u00e3o onde tokens s\u00e3o amarrados em funcionalidades ou clientes. Em outras palavras, voc\u00ea pode especificar quais recursos de um servi\u00e7o voc\u00ea quer permitir a um token do OAuth que esteja ligado a ele, e voc\u00ea pode emitir v\u00e1rios tokens e amarr\u00e1-los a espec\u00edficos clientes: celular, laptop, smart watch ou [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":360,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[70,71],"tags":[],"class_list":["post-668","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-git","category-github"],"_links":{"self":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/668","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/comments?post=668"}],"version-history":[{"count":1,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/668\/revisions"}],"predecessor-version":[{"id":669,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/posts\/668\/revisions\/669"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/media\/360"}],"wp:attachment":[{"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/media?parent=668"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/categories?post=668"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/micheladrianomedeiros.com.br\/blog\/wp-json\/wp\/v2\/tags?post=668"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}