Atlassian Marketplace에서 Application Tunnel 설치

자체 관리형 인스턴스에 Application Tunnel 설치 가이드

1. https://marketplace.atlassian.com/apps/1227901/application-tunnels?tab=overview&hosting=datacenter 이동

2. Get it now 버튼 클릭하여 설치 파일 다운로드

   

3. Jira / Confluence의 앱관리 화면에서 앱 업로드 클릭하여 다운로드한 설치파일 선택 후 업로드

   

4. 앱 설치 후 확인

   1. Jira : 관리 > 응용 프로그램 > Application Tunnel

      

   2. Confluence : 관리 > 일반 환경 설정 > Application Tunnel

      

필수 연결 및 업스트림 포트 구성

네트워크에서 나가는 연결을 허용하고 HTTP 커넥터와 업스트림 포트를 추가하여 자체 관리형 인스턴스가 터널에 연결할 수 있도록 합니다.

네트워크에서 나가는 연결 허용

포트 443에서 발신 연결 허용:

• 터널을 생성할 때 자체 관리형 인스턴스는 클라우드 측의 터널 엔드포인트인 https://tunnel.services.atlassian.com에 도달해야 합니다.

• 절차의 마지막 단계로 애플리케이션 링크를 승인할 때 자체 관리형 인스턴스가 클라우드 제품에 직접 도달해야 합니다. 발신 통신이 터널을 사용하지 않습니다.

네트워크 또는 IP 범위로 들어오는 연결을 허용할 필요가 없습니다.

HTTP 커넥터 및 업스트림포트 추가

인스턴스를 중지하고 다음 단계를 완료합니다.

Jira, Bamboo

1. 설치 디렉토리에서 conf/server.xml 파일을 편집합니다.

2. 다음 커넥터 중 하나를 추가합니다. 이 인스턴스의 애플리케이션에서 아직 사용하지 않은 포트 번호를 사용하십시오.

   1. Jira

      <Connector port="8081" connectionTimeout="20000" maxThreads="200" minSpareThreads="10" 
                         enableLookups="false" acceptCount="10" URIEncoding="UTF-8"
                         relaxedPathChars="[]|" relaxedQueryChars="[]|{}^&#x5c;&#x60;&quot;&lt;&gt;"/>

   2. Bamboo

      <Connector port="8093" connectionTimeout="20000" maxThreads="200" minSpareThreads="10" 
                         enableLookups="false" acceptCount="10" URIEncoding="UTF-8" />

3. 다음 스니펫을 setenv.sh의 JVM_SUPPORT_RECOMMENDED_ARGS에 추가합니다. 위의 HTTP 커넥터에 사용한 것과 같은 포트 번호를 지정합니다.

   -Dsecure.tunnel.upstream.port=$portNumber

Confluence

1. 설치 디렉토리에서 conf/server.xml 파일을 편집합니다.

2. 다음 커넥터 중 하나를 추가합니다. 이 인스턴스의 애플리케이션에서 아직 사용하지 않은 포트 번호를 사용하십시오.

   <Connector port="8093" connectionTimeout="20000" maxThreads="200" minSpareThreads="10" 
                      enableLookups="false" acceptCount="10" URIEncoding="UTF-8" />

3. 다음 스니펫을 setenv.sh의 CATALINA_OPTS에 추가합니다. 위의 HTTP 커넥터에 사용한 것과 같은 포트 번호를 지정합니다.

   -Dsecure.tunnel.upstream.port=$portNumber

Bitbucket

1. Bitbucket 홈 디렉터리에서 shared/bitbucket.properties 파일을 편집합니다.

2. 커넥터와 업스트림 포트를 추가합니다. 이 인스턴스의 애플리케이션에서 아직 사용하지 않는 포트 번호를 사용하십시오. 

   server.additional-connector.1.port=8081
   plugin.secure.tunnel.upstream.port=8081

선택 사항: HTTP 커넥터에 대한 액세스를 localhost로 제한

보안을 강화하기 위해 새로 만든 커넥터에 대한 액세스를 제한할 수 있습니다. 다음 예에서는 localhost 주소(애플리케이션 터널에 필요)가 모든 포트에 액세스할 수 있도록 허용하고 외부 접근을 포트 8080으로 제한하고 있습니다.이 포트 8080은 공개 포트입니다.

커넥터에 대한 액세스를 제한하려면:

1. 설치 디렉토리에서 conf/server.xml 파일을 편집하십시오.

2. <Engine>섹션 에 다음 스니펫을 추가합니다 . 포트 번호(8080)를 공개적으로 액세스할 수 있는 포트로 조정해야 합니다.

   <Valve className="org.apache.catalina.valves.RemoteAddrValve" addConnectorPort="true" allow="127.0.0.1;\d*|::1;\d*|.*;8080"/>

web.xml 파일에서 HTTPS 리디렉션 제거

인스턴스에 SSL을 활성화한 경우 다음 스니펫을 사용하여 트래픽을 HTTPS로 리디렉션했을 수 있습니다. 새 커넥터가 HTTP를 사용하므로 트래픽이 리디렉션되지 않도록 이 스니펫을 제거해야 합니다. 터널을 통과하는 트래픽은 모두 암호화되지만 일부 트래픽이 HTTP 상의 일반 포트에 도달하려고 하면 리다이렉트되지 않습니다.

Jira, Confluence, Bamboo

1. 설치 디렉토리에서 conf/web.xml 파일을 편집합니다.

2. 다음의 스니펫을 삭제합니다.

   <security-constraint>
     <web-resource-collection>
       <web-resource-name>all-except-attachments</web-resource-name>
       <url-pattern>*.jsp</url-pattern>
       <url-pattern>*.jspa</url-pattern>
       <url-pattern>/browse/*</url-pattern>
   	<url-pattern>/issues/*</url-pattern> 
     </web-resource-collection>
     <user-data-constraint>
       <transport-guarantee>CONFIDENTIAL</transport-guarantee>
     </user-data-constraint>
   </security-constraint>

3. 인스턴스를 시작합니다.

Bitbucket

1. Bitbucket 홈디렉토리에서 shared/bitbucket.properties 파일을 편집합니다.

2. server.require-ssl 속성을 삭제합니다.

자체 관리형 인스턴스에 대한 Application tunnel 생성

Admin.atlassian.com 에서 터널 만들기

1. admin.atlassian.com으로 이동 하여 조직을 선택합니다.

2. 설정 > 애플리케이션 터널 로 이동합니다 .

3. 터널 만들기 를 선택 합니다.

4. 마법사를 통해 자체 관리형 인스턴스의 세부 정보를 제공하고 터널과 연결된 보안 키를 생성합니다.

5. 자체 관리형 인스턴스에 키를 추가합니다. 인스턴스로 리디렉션되도록 선택하거나 키를 복사하여 이 인스턴스의 관리자에게 제공하여 수동으로 추가할 수 있도록 할 수 있습니다.

자체 관리형 인스턴스에 터널의 보안 키 추가

터널의 보안 키를 추가하려면:

1. 애플리케이션 터널로 이동:

   • 클라우드에서 여기로 리디렉션된 경우 이미 올바른 화면으로 이동해야 합니다.

   • 리디렉션되지 않은 경우 Administration > Application tunnel 로 이동하고 Add security key를 선택 합니다 .

2. 보안 키를 붙여넣고 마법사의 단계를 따릅니다.

터널링된 애플리케이션 링크 생성

터널링된 애플리케이션 링크를 사용하면 대상 인스턴스의 URL을 사용하는 직접 링크와 달리 대상 인스턴스로 트래픽을 전송하기 위해 사용되는 기존 애플리케이션 터널을 선택할 수 있습니다. 클라우드 제품에서만 터널링된 애플리케이션 링크를 생성할 수 있습니다.

클라우드 제품에서 터널링된 애플리케이션 링크 생성

터널링된 애플리케이션 링크를 생성하려면:

1. 클라우드 제품 관리를 열고 애플리케이션 링크로 이동합니다. 이것은 admin.atlassian.com 과 다르며 각 제품에는 자체 관리가 있습니다.

   • Jira Cloud: 관리 > 제품 > 애플리케이션 연결로 이동합니다.

   • Confluence Cloud: 관리 > 응용프로그램 연결로 이동합니다.

2. 링크 만들기를 선택합니다.

3. 링크 만들기 화면에서 터널링된 애플리케이션 링크를 선택한 다음 자체 관리형 인스턴스에 연결된 애플리케이션 터널을 선택합니다. 그런 다음 계속을 선택합니다.

4. URL 확인 화면에서 URL을 확인합니다. 애플리케이션 URL은 터널의 URL을 표시하고 표시 URL은 자체 관리형 인스턴스의 기본 URL을 표시해야 합니다.

5. Review link 화면에서 연결 중인 제품의 세부 정보를 볼 수 있습니다.

다음으로 상호 링크를 구성합니다. 단계는 자체 관리형 인스턴스의 관리자인지 여부에 따라 다릅니다.

자체 관리형 인스턴스의 관리자입니다.

1. Review link 화면에서 I am administrator on both instance 체크박스를 선택합니다.

2. 계속을 선택합니다. 링크를 확인할 수 있는 자체 관리형 인스턴스로 리디렉션됩니다.

3. 확인한 후 클라우드 사이트로 다시 리디렉션됩니다.

4. 애플리케이션 링크는 두 인스턴스 모두에 Connected 상태로 생성됩니다 .

자체 관리형 인스턴스의 관리자가 아닙니다.

1. Review link 화면에서 I am administrator on both instance 체크박스를 선택 취소합니다.

2. 계속을 선택합니다. URL이 포함된 팝업이 표시됩니다.

3. URL을 복사하여 자체 관리형 인스턴스의 관리자에게 제공합니다.

4. 관리자가 URL을 열면 자체 관리형 인스턴스의 애플리케이션 링크 페이지로 이동됩니다. 링크를 확인해야 합니다.

5. 상호 링크가 생성되지만 두 인스턴스의 애플리케이션 링크는 구성 오류 를 표시할 가능성이 높습니다 .

6. 이 문제를 해결하려면 클라우드 제품에서 애플리케이션 링크를 편집하십시오. 수신 및 발신 통신 모두에 대해 로컬 인증을 OAuth로 설정합니다.

애플리케이션 터널 troubleshooting

다음은 애플리케이션 터널에 대한 몇 가지 troubleshooting 정보입니다.

자체 관리형 인스턴스에서 추가 로그인 활성화

이 페이지에서 솔루션을 찾을 수 없는 경우 com.atlassian.tunnel 의 로그 수준 을 TRACE 로 설정 하고 주요 클래스에 대한 참조를 찾으십시오.

• TunnelConnectionService

• InletsClientManager

• TunnelClientProcessStateManager

• InletsClientProcessFactory

다른 제품에 대한 로깅을 활성화하는 방법에 대한 자세한 내용은 다음을 참조하십시오.

• Jira: Logging and profiling

• Confluence: Configure logging

• Bitbucket: Enable debug logging

• Bamboo: Logging in Bamboo

일반적인 문제

다음과 같은 문제가 발생할 수 있습니다.