<div id="readability-page-1" class="page">






<nav id="global-navigation">


</nav>
<main id="wrap" aria-hidden="false">

<div>






<article>
<header id="global-header">



<div>
<h2>[confluence to tistory-4]Confluence Api도 OAuth2.0으로</h2>
<ul>
<li role="text" aria-label="2021년 10월 10일 21시 43분에 작성된 글."><time datetime="2021-10-10T21:43">2021.10.10 21:43</time></li>
<li><a href="/category/%EA%B0%9C%EB%B0%9C%20%EC%9D%B4%EA%B2%83%EC%A0%80%EA%B2%83" aria-label="개발 이것저것">개발 이것저것</a></li>
</ul>
</div>


</header>
<div id="article"><p data-ke-size="size16">Tistory Api 덕분에 OAuth2.0의 원리 및 활용법을 알게 되었는데, 생각해보니 사용자를 위해서라면 Confluence Api를 사용할 때도 OAuth2.0 방식으로 해야겠다는 생각이 되어 찾아보니, Confluence에서도 OAuth2.0을 지원하고 있었다.</p>

<h3 id="id-[confluencetotistory-4]ConfluenceApi도OAuth2.0으로-OAuth2.0앱등록" data-ke-size="size23">OAuth2.0 앱 등록</h3>
<p data-ke-size="size16">당연한 이야기 이지만 Confluence도 OAuth2.0 인증을 사용하기 위해서는 개발자 콘솔에서 어플리케이션을 등록하고, AppID 및 Secret등을 발급 받아야 한다. 순서는 다음과 같다.</p>
<ol data-ke-list-type="disc">
<li><a href="https://developer.atlassian.com/console/myapps/" rel="nofollow">개발자 콘솔의 Myapps</a>에서 Create app버튼에서 <code>OAuth 2.0 (3LO) integration</code> 을 선택한다.</li>
<li>만들 어플리케이션의 이름을 입력하고 생성한다.</li>
<li>방금 생성한 항목에 접속해서 <code>Permissions</code> 탭에서 사용할 어플리케이션의 사용가능 권한을 세팅한다.<figure width="1511" height="655" data-origin-width="1511" data-origin-height="655" data-ke-mobilestyle="widthOrigin"><span data-url="https://blog.kakaocdn.net/dn/clI7Hk/btrhlAjDkLW/lqg4rIFMdIL4zyzkXRyQMk/img.png" data-lightbox="lightbox" data-alt=""><img src="https://blog.kakaocdn.net/dn/clI7Hk/btrhlAjDkLW/lqg4rIFMdIL4zyzkXRyQMk/img.png" width="1511" height="655" data-origin-width="1511" data-origin-height="655" data-ke-mobilestyle="widthOrigin"></span></figure>우리는 Confluence API를 사용할 것이기 때문에 해당 항목의 권한을 설정한다. 이후에 OAuth 인증을 호출할때에 관련하여 권한을 다시 입력하지만, 본 페이지에서 허용한 권한보다 많은 권한을 요구할 수 없다.</li>
<li><code>Authorization</code> 탭 → <code>Configure</code> 버튼을 눌러서 Callback URL을 설정해 준다.<figure width="1010" height="464" data-origin-width="1010" data-origin-height="464" data-ke-mobilestyle="widthOrigin"><span data-url="https://blog.kakaocdn.net/dn/ow4IW/btrhgkPpODd/DcRg37zK6lNLiOXp8oknk1/img.png" data-lightbox="lightbox" data-alt=""><img src="https://blog.kakaocdn.net/dn/ow4IW/btrhgkPpODd/DcRg37zK6lNLiOXp8oknk1/img.png" width="1010" height="464" data-origin-width="1010" data-origin-height="464" data-ke-mobilestyle="widthOrigin"></span></figure>이후에 OAuth2.0 인증을 사용자가 완료하고 나면, 여기에 작성한 Callback URL로 인증코드가 쿼리파라미터로 전달된다. 아직 Listening이 가능한 주소가 없다면 접근 가능한 임시 URL을 작성하여 개발하고 이후에 수정하면 된다.</li>
<li><code>Settings</code> 화면의 하단에 있는 <code>Client ID</code> 와 <code>Secret</code> 값을 저장해 둔다.<br><figure width="1098" height="507" data-origin-width="1098" data-origin-height="507" data-ke-mobilestyle="widthOrigin"><span data-url="https://blog.kakaocdn.net/dn/1LJiu/btrhe0KCNGK/Sf9JIsTQ4LQ7GNGb7wFMcK/img.png" data-lightbox="lightbox" data-alt=""><img src="https://blog.kakaocdn.net/dn/1LJiu/btrhe0KCNGK/Sf9JIsTQ4LQ7GNGb7wFMcK/img.png" width="1098" height="507" data-origin-width="1098" data-origin-height="507" data-ke-mobilestyle="widthOrigin"></span></figure>이후 OAuth 인증유도 화면이나 인증코드를 활요한 토큰 생성시 필요한 값이다.</li>
</ol>
<h3 id="id-[confluencetotistory-4]ConfluenceApi도OAuth2.0으로-사용자인증화면URL" data-ke-size="size23">사용자 인증 화면 URL</h3>
<figure width="868" height="807" data-origin-width="868" data-origin-height="807" data-ke-mobilestyle="widthOrigin"><span data-url="https://blog.kakaocdn.net/dn/bkpYcJ/btrhet0CwgO/qznR2yitPVVLWAlSJ6u8U0/img.png" data-lightbox="lightbox" data-alt=""><img src="https://blog.kakaocdn.net/dn/bkpYcJ/btrhet0CwgO/qznR2yitPVVLWAlSJ6u8U0/img.png" width="868" height="807" data-origin-width="868" data-origin-height="807" data-ke-mobilestyle="widthOrigin"></span></figure>
<div>
<table data-ke-style="style12" data-layout="default" data-ke-align="alignLeft"><colgroup><col><col><col></colgroup>
<tbody>
<tr>
<td><b>구분</b></td>
<td><b>정보</b></td>
<td><b>비고</b></td>
</tr>
<tr>
<td>API 경로</td>
<td><code>https://auth.atlassian.com/authorize</code></td>
<td>&nbsp;</td>
</tr>
<tr>
<td>매서드</td>
<td>GET</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>Query 파라미터1</td>
<td>scope</td>
<td>값 : 필요한 권한 목록 표 하단 참조</td>
</tr>
<tr>
<td>Query 파라미터2</td>
<td>redirect_uri</td>
<td>값: app 등록시 등록한 redirect주소</td>
</tr>
<tr>
<td>Query 파라미터3</td>
<td>state</td>
<td>값: 아무값이나 가능</td>
</tr>
<tr>
<td>Query 파라미터4</td>
<td>response_type</td>
<td>값: code (고정)</td>
</tr>
<tr>
<td>Query 파라미터5</td>
<td>prompt</td>
<td>값: consent (고정)</td>
</tr>
<tr>
<td>호출 목적</td>
<td>OAuth2.0 사용자 로그인 유도 화면 URL</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
</div>
<p data-ke-size="size16"><code>scope</code> 파라미터에 입력해야 하는 값은 사용할 API가 요구하는 권한에 따라 달라진다 여러개의 scope를 작성해야 하는 경우에는 공백(%20)으로 구분해서 전달하면된다. 필요한 scope는 Confluence API문서를 참조하면 각각의 API가 필요로 하는 scope가 명시되어 있으니 참고하여 작성하면 된다. 내가 만들 프로그램에서는 space와 content관련 읽기 권한만 있으면 되어서 scope값으로 아래와 같은 값을 전달하였다.</p>
<ul data-ke-list-type="disc">
<li>전달한 값 : <code>read:confluence-space.summary read:confluence-content.summary</code></li>
</ul>
<figure width="815" height="406" data-origin-width="815" data-origin-height="406" data-ke-mobilestyle="widthOrigin"><span data-url="https://blog.kakaocdn.net/dn/p7vY5/btrhn3FRQgb/hKpp42B8c5njKLDEsXVJM0/img.png" data-lightbox="lightbox" data-alt=""><img src="https://blog.kakaocdn.net/dn/p7vY5/btrhn3FRQgb/hKpp42B8c5njKLDEsXVJM0/img.png" width="815" height="406" data-origin-width="815" data-origin-height="406" data-ke-mobilestyle="widthOrigin"></span></figure>
<h3 id="id-[confluencetotistory-4]ConfluenceApi도OAuth2.0으로-인증코드를이용하여토큰생성" data-ke-size="size23">인증코드를 이용하여 토큰 생성</h3>
<p data-ke-size="size16">사용자 인증 페이지를 통해 사용자가 인증을 정상적으로 수행하고 나면, <code>redirect_url</code> 쪽으로 <code>code</code> 쿼리 파라미터에 인증코드가 담긴 요청이 리다이렉트 된다. 서버에서는 해당 값을 이용해서 Confluence서버로 부터 API 요청시 사용할 수 있는 토큰을 요청할 수 있게 된다.</p>
<div>
<table data-ke-style="style12" data-layout="default" data-ke-align="alignLeft"><colgroup><col><col><col></colgroup>
<tbody>
<tr>
<td><b>구분</b></td>
<td><b>정보</b></td>
<td><b>비고</b></td>
</tr>
<tr>
<td>API 경로</td>
<td><code>https://auth.atlassian.com/oauth/token</code></td>
<td>&nbsp;</td>
</tr>
<tr>
<td>매서드</td>
<td>POST</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>json 파라미터1</td>
<td>grant_type</td>
<td>값 : authorization_code (고정)</td>
</tr>
<tr>
<td>json 파라미터2</td>
<td>client_id</td>
<td>값: app 등록 후 생성된 id</td>
</tr>
<tr>
<td>json 파라미터3</td>
<td>client_secret</td>
<td>값: app 등록 후 생성된 secret</td>
</tr>
<tr>
<td>json 파라미터4</td>
<td>code</td>
<td>값: 전달받은 인증코드</td>
</tr>
<tr>
<td>json 파라미터5</td>
<td>redirect_uri</td>
<td>값: app 등록시 등록한 redirect주소</td>
</tr>
<tr>
<td>호출 목적</td>
<td>토큰 생성</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
</div>
<h3 id="id-[confluencetotistory-4]ConfluenceApi도OAuth2.0으로-토큰활용하기" data-ke-size="size23">토큰 활용하기</h3>
<p data-ke-size="size16">이러한 과정을 통해서 발급받은 토큰은 요청 헤더에 <code>Authorization</code> 를 추가하고, 값으로 <code>Bearer 토큰</code> 을 선언하여 API를 요청하는데 사용할 수 있다.</p>
<div data-hasbody="true" data-macro-id="deff12cd-776b-44bc-8bb6-7b9a1a3d1c03" data-macro-name="code">
<pre data-syntaxhighlighter-params="brush: java; gutter: false; theme: Confluence" data-theme="Confluence"><code>curl --request GET \
  --url https://api.atlassian.com/oauth/token/accessible-resources \
  --header 'Authorization: Bearer ACCESS_TOKEN' \
  --header 'Accept: application/json'</code></pre>
</div>
<h3 id="id-[confluencetotistory-4]ConfluenceApi도OAuth2.0으로-API호출URL을더욱스마트하게" data-ke-size="size23">API 호출 URL을 더욱 스마트하게</h3>
<p data-ke-size="size16">이전에 Confluence API를 호출할 때 현재 접속한 컨플루언스 스페이스 URL을 기준으로 뒤에 API주소를 붙여서 호출했었는데, 이렇게 하면 API호출시 사용하는 BaseURL이 사용자마다 달라지게 되어서 관리가 매우 어려웠다. 하지만, 이번에 OAuth2.0을 적용하면서 관련 문서의 내용을 살펴보니, 토큰에 부여된 권한으로 API질의가 가능한 항목에 대한 ID값을 조회하여 좀더 스마트하게 API를 호출하는 방법에 대한 가이드가 존재해서 기존의 URL호출방식에서 변경하기로 하였다.</p>
<ul data-ke-list-type="disc">
<li>기존 URL 형식 : <a href="https://geunsam2.atlassian.net/wiki" rel="nofollow">https://&lt;사용자Space명&gt;.atlassian.net/wiki</a></li>
<li>신규 URL 형식 : <a href="https://api.atlassian.com/ex/confluence/" rel="nofollow">https://api.atlassian.com/ex/confluence/</a>&lt;ID값&gt;</li>
</ul>
<div>
<table data-ke-style="style12" data-layout="default" data-ke-align="alignLeft"><colgroup><col><col><col></colgroup>
<tbody>
<tr>
<td><b>구분</b></td>
<td><b>정보</b></td>
<td><b>비고</b></td>
</tr>
<tr>
<td>API 경로</td>
<td><code>https://api.atlassian.com/oauth/token/accessible-resources</code></td>
<td>&nbsp;</td>
</tr>
<tr>
<td>매서드</td>
<td>POST</td>
<td>&nbsp;</td>
</tr>
<tr>
<td>헤더</td>
<td>Authorization</td>
<td>값: <code>Bearer &lt;토큰&gt;</code></td>
</tr>
<tr>
<td>호출 목적</td>
<td>조회할 항목 ID값 확인</td>
<td>&nbsp;</td>
</tr>
</tbody>
</table>
</div>
<p data-ke-size="size16">예를 들어 호출할 ID값이 123asd456 이고, space목록을 조회하는 api <code>/rest/api/space</code> 를 호출하려고 하면 다음과 같은 주소로 호출하면 된다.</p>
<div data-hasbody="true" data-macro-id="99c2f7dd-7ef3-473b-bd14-5d98dab7561c" data-macro-name="code">
<pre data-syntaxhighlighter-params="brush: java; gutter: false; theme: Confluence" data-theme="Confluence"><code>https://api.atlassian.com/ex/confluence/123asd456/rest/api/space</code></pre>
</div>
            </div>




<nav>
<ul>
<li></li>
<li></li>
<li></li>
</ul>
</nav>



















</article>


</div>
</main>

<nav id="pagination">

</nav>












	            
            
            
                        
                        
                                       
                                               
        
</div>

모두의 근삼이

염근철

Tistory Api 덕분에 OAuth2.0의 원리 및 활용법을 알게 되었는데, 생각해보니 사용자를 위해서라면 Confluence Api를 사용할 때도 OAuth2.0 방식으로 해야겠다는 생각이 되어 찾아보니, Confluence에서도 OAuth2.0을 지원하고 있었다. OAuth2.0 앱 등록 당연한 이야기 이지만 Confluence도 OAuth2.0 인증을 사용하기 위해서는 개발자 콘솔에서 어플리케이션을 등록하고, AppID 및 Secret등을 ..

[confluence to tistory-4]Confluence Api도 OAuth2.0으로

댓글