앱 추가 및 등록—ArcGIS Online 도움말

기존 앱에 URL 레퍼런스를 추가하면 내 기관의 구성원 및 모든 사용자와 작업을 효과적으로 공유할 수 있습니다(공유 권한에 따라). URL 외에 앱의 유형, 앱의 용도, 요약 및 설명과 같은 기타 세부정보와 앱을 생성하는 데 사용한 코드가 포함된 .zip 파일을 공유할 수 있습니다. ArcGIS Online에 앱을 추가하는 경우 앱 URL에 대한 참조만 추가되고 ArcGIS Online에 앱 파일이 저장되지는 않습니다.

기관 계정이 있는 앱 개발자는 플랫폼에 앱을 등록할 수도 있습니다. 여기에는 기관 구성원 및 기관 외부의 사용자가 앱에 로그인할 수 있도록 OAuth 애플리케이션을 등록하는 과정이 포함됩니다. 자세한 내용은 아래의 개발자 자격 증명을 사용하여 앱 추가 및 등록 섹션을 참고하세요.

앱을 등록할 필요가 없는 경우(예시: 코드 샘플을 업로드하는 경우) 아래의 URL에서 앱 추가 섹션의 단계를 따릅니다.

팁:

기관의 구성원 및 모든 사용자와 앱을 공유하는 또 다른 방법은 맵이 포함된 앱 및 그룹이 포함된 갤러리 앱을 생성하는 것입니다.

URL에서 앱 추가

웹에서 앱에 접근하는 데 URL을 사용하지만 등록할 필요가 없는 항목(예시: 코드 샘플)을 추가하려면 다음 단계를 따릅니다.

비고:

등록된 앱을 추가하려면 개발자 자격 증명을 사용하여 앱을 추가하고 등록하는 단계를 따릅니다.

로그인되어 있고 콘텐츠를 생성, 업데이트, 삭제할 권한이 있는지 확인합니다.
콘텐츠 페이지의 내 콘텐츠 탭에서 새 항목을 클릭한 다음 응용프로그램을 클릭합니다.
앱 유형을 선택합니다.
- 웹 매핑 — JavaScript와 같은 웹 API로 작성된 웹 앱입니다.
- 데스크톱 — Java나 .NET(Microsoft Windows 데스크톱)와 같은 데스크톱 플랫폼에서 작성된 데스크톱용 앱
- 모바일 — iOS 또는 Android와 같은 SDK로 작성된 다운로드 가능한 모바일 기기용 앱
- 기타 응용프로그램 — 데스크톱 응용프로그램, Python 스트립트 또는 응용프로그램의 용도, API, SDK, URL 주소에 대한 세부정보가 없는 모든 유형의 일반 앱
웹 매핑, 데스크톱 또는 모바일의 경우 앱 URL(예시: https://<myServer>/myWebMapApp)을 입력합니다.
데스크톱 앱의 경우 찾아보기를 클릭하고 앱을 포함하는 .zip 파일을 선택합니다.
다음을 클릭합니다.
제목을 입력합니다.
내 콘텐츠에서 항목을 저장할 폴더를 선택합니다.
또는 메뉴에서 새 폴더 생성을 선택하고 폴더 이름을 입력하여 항목을 새 폴더에 저장할 수 있습니다.
폴더 이름에는 4바이트 유니코드 문자를 포함할 수 없습니다.
기관에 콘텐츠 범주가 설정되어 있는 경우 범주 할당을 클릭한 다음 다른 사용자가 항목을 손쉽게 찾을 수 있도록 최대 20개의 범주를 선택합니다.
범주 이름을 입력하여 범주 목록의 범위를 좁힐 수도 있습니다.
필요한 경우 항목을 설명하는 태그를 입력합니다.
용어를 쉼표로 구분합니다. 예를 들어 Federal land는 하나의 태그로 구분되지만 Federal, land는 두 개의 태그로 간주됩니다.
입력할 때 표시되는 추천 태그 중 하나를 선택할 수 있습니다. 추천 태그는 사용자가 이전에 추가한 태그에서 생성됩니다.
필요한 경우 앱에 대한 간단한 설명을 추가합니다.
저장을 클릭합니다.

앱을 추가하면 콘텐츠에 앱이 표시됩니다. 앱의 항목 페이지에 있는 설정 탭에서 나중에 등록할 수도 있습니다. 자세한 내용은 아래의 개발자 자격 증명을 사용하여 앱 추가 및 등록 섹션을 참고하세요.

항목 세부정보를 구성하고 필요한 경우 코드를 첨부하고 공유 권한이 있는 경우 앱을 공유할 수 있습니다.

개발자 자격 증명을 사용하여 앱 추가 및 등록

기관 계정이 있는 개발자는 플랫폼에 앱을 추가 및 등록하여 앱 ID를 생성할 수 있습니다. 앱에서 앱 ID를 사용하여 사용 내역 통계를 수집하고 사용자가 표준 인증 프레임워크인 OAuth 2.0을 사용하여 플랫폼에 로그인하도록 허용할 수 있습니다. OAuth 2.0을 사용하면 앱은 사용자가 플랫폼 호스팅 로그인 페이지를 통해 플랫폼에 로그인하도록 안내합니다. 또한 OAuth 2.0을 통해 앱에서 기관과 관련된 사용자 콘텐츠를 사용하고 지오코딩, 경로, GeoEnrichment와 같은 기타 ArcGIS Online 기능을 사용할 수 있습니다. 인증 및 OAuth 2.0에 대한 자세한 내용은 Esri Developer를 참고하세요.

또는 앱을 등록할 때 앱에 API 키를 임베드할 수 있습니다.

앱에 포함할 수 있는 개발자 자격 증명의 유형은 기관에서의 권한에 따라 달라집니다. 기본 관리자 역할의 구성원이거나 API 키 생성 권한이 있는 사용자 설정 역할의 구성원인 경우, 앱에 OAuth 2.0 또는 API 키 자격 증명을 사용할 수 있습니다. 그렇지 않은 경우 앱에 OAuth 2.0 개발자 자격 증명만 사용할 수 있습니다.

비고:

사용자 로그인의 구현 패턴은 웹 기반 앱을 개발하는지, 네이티브 앱을 개발하는지에 따라 약간 다릅니다. Esri Developer 문서에 웹 기반 앱과 네이티브 앱 둘 다에 대한 세부정보 및 코드 샘플이 포함되어 있습니다.

OAuth 2.0 자격 증명이 임베드된 앱 추가 및 등록

만드는 앱에서 OAuth 2.0 자격 증명을 사용하는 경우, 앱에 액세스할 때 액세스 토큰이 동적으로 생성됩니다. 액세스 토큰은 최대 14일 동안 유효합니다.

역할에 API 키를 생성할 권한이 없는 경우 아래 단계를 따릅니다.

콘텐츠를 생성, 업데이트, 삭제할 권한이 있는 기관 계정으로 로그인되어 있는지 확인합니다.
콘텐츠 페이지의 내 콘텐츠 탭을 클릭하고 새 항목을 클릭합니다.
새 항목 창에서 개발자 자격 증명을 클릭합니다.

표시되는 첫 번째 창은 기관에서의 권한에 따라 달라집니다. 역할에 API 키를 생성할 권한이 없는 구성원인 경우 5단계를 진행하세요. 역할에 API 키를 생성할 권한이 있는 경우 4단계를 진행하세요.

OAuth 2.0 자격 증명 옵션을 선택하고 다음을 클릭합니다.
리디렉션 URL에 사용자가 성공적으로 로그인한 후 사용자를 리디렉션하는 데 사용될 웹페이지 또는 서버 엔드포인트 URL을 입력합니다. 필요에 따라 추가를 클릭하여 리디렉션 URL을 더 추가합니다.
인증하는 동안 지정된 리디렉션 URL은 등록된 URL 중 하나와 일치해야 하며, 그렇지 않으면 인증이 거부됩니다.
인증 허가를 위해 urn:ietf:wg:oauth:2.0:oob의 특별 값을 지정할 수도 있습니다. 그 결과로 인증 코드가 포털 URL(/oauth2/approval)로 전달됩니다. 이 값은 일반적으로 코드가 전달될 수 있는 웹 서버나 사용자 설정 URL 스키마가 없는 앱에서 사용됩니다.
지원되는 리디렉션 URL 형식의 예시는 다음과 같습니다.
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
참조 URL에 연결이 허용된 URL 또는 IP 주소를 입력합니다. 필요에 따라 추가를 클릭하여 참조 URL 또는 IP 주소를 더 추가합니다.
애플리케이션 환경에서 앱의 애플리케이션 환경을 선택합니다(다중, 네이티브, 브라우저 또는 서버).
URL 상자에 https://<myServer>/myWebMapApp 형식으로 앱의 URL을 입력합니다.
다음을 클릭합니다.
OAuth 2.0 애플리케이션에 권한을 할당할 권한이 있는 역할의 구성원인 경우, 다음을 클릭하면 앱에서 허용되는 동작을 정의할 수 있는 창으로 이동하게 됩니다. 이 권한이 없는 경우 12단계를 진행하세요.
권한을 할당하여 자격 증명을 통해 앱에서 수행할 수 있는 동작을 선택하고 다음을 클릭합니다.
사용 가능한 권한의 목록은 ArcGIS Location Platform 구독이 있는지 여부 및 기관에서의 권한에 따라 달라집니다. 계정이 소유하지 않은 권한은 할당할 수 없습니다.
권한 유형에 대한 자세한 내용은 Esri 개발자 도움말의 보안 및 인증 가이드를 참조하세요.
항목 찾아보기를 클릭하여 임베드된 자격 증명을 통해 접근할 수 있는 항목을 선택하고 항목 추가를 클릭합니다.
또는 건너뛰기를 클릭할 수 있습니다.
제목을 입력합니다.
내 콘텐츠에서 항목을 저장할 폴더를 선택합니다.
또는 메뉴에서 새 폴더 생성을 선택하고 폴더 이름을 입력하여 항목을 새 폴더에 저장할 수 있습니다.
폴더 이름에는 4바이트 유니코드 문자를 포함할 수 없습니다.
기관에 콘텐츠 범주가 설정되어 있는 경우 범주 할당을 클릭한 다음 다른 사용자가 항목을 손쉽게 찾을 수 있도록 최대 20개의 범주를 선택합니다.
범주 이름을 입력하여 범주 목록의 범위를 좁힐 수도 있습니다.
필요한 경우 항목을 설명하는 태그를 입력합니다.
용어를 쉼표로 구분합니다. 예를 들어 Federal land는 하나의 태그로 구분되지만 Federal, land는 두 개의 태그로 간주됩니다.
입력할 때 표시되는 추천 태그 중 하나를 선택할 수 있습니다. 추천 태그는 사용자가 이전에 추가한 태그에서 생성됩니다.
필요한 경우 앱에 대한 간단한 설명을 추가합니다.
다음을 클릭합니다.
자격 증명 요약을 검토합니다. 설정을 변경하려면 뒤로를 클릭하여 항목을 생성하기 전에 변경합니다.
자격 증명에 대한 개인 권한을 부여한 경우 보안 승인서 옆에 있는 체크 박스를 선택하여 해당 승인서를 읽고 동의했음을 확인한 후 생성을 클릭하여 자격 증명을 생성합니다.

앱이 콘텐츠에 추가되며 앱의 항목 페이지가 나타납니다. 항목 페이지에, 그리고 콘텐츠 페이지 또는 항목 미리 보기 창에서 항목을 볼 때 앱에서 OAuth 2.0 자격 증명이 사용된다는 것을 나타내는 배지가 표시됩니다. 항목 페이지의 오버뷰 탭에서 이 배지는 자격 증명에 개인 권한이 포함되어 있는지 아니면 표준 권한만 포함되어 있는지를 나타냅니다.

앱의 항목 세부정보를 구성할 수 있습니다.

설정 탭의 사용 내역 보기를 클릭하여 앱에 로그인한 사용자의 정보와 사용한 크레딧 수를 확인할 수 있습니다.

비고:

ArcGIS Location Platform 구독을 통해 로그인한 경우 사용 내역 보기 섹션을 사용할 수 없습니다.

앱에 임베드된 자격 증명에 대한 설정을 관리할 수도 있습니다.

API 자격 증명이 임베드된 앱 추가 및 등록

앱에 자격 증명을 임베드해야 하며 키의 유효 기간이 14일을 초과해야 하는 경우 API 키 자격 증명을 사용합니다.

앱을 추가하고, 앱에 임베드된 API 키를 생성하여 인증 목적으로 사용하려면 아래 단계를 따릅니다.

기관 계정으로 로그인되어 있으며 API 키를 생성하고 콘텐츠를 생성, 업데이트, 삭제할 권한이 있는지 확인합니다.
콘텐츠 페이지의 내 콘텐츠 탭을 클릭하고 새 항목을 클릭합니다.
새 항목 창에서 개발자 자격 증명을 클릭합니다.
API 키 자격 증명 옵션을 선택하고 다음을 클릭합니다.
캘린더를 사용하여 자격 증명 만료일을 지정합니다.
자격 증명은 다음 날(최소) 또는 365일 후(최대)에 만료되도록 지정할 수 있습니다. 만료일로 선택한 날의 오후 11시 59분에 만료됩니다. 시간은 앱을 추가하고 자격 증명을 생성할 때의 브라우저 시간을 기준으로 저장됩니다.
참조 URL에 앱에 연결하도록 허용된 URL 또는 IP 주소를 입력합니다. 추가를 클릭하여 필요한 참조 URL 또는 IP 주소를 더 추가합니다.
인증하는 동안 지정된 URL은 등록된 URL 중 하나와 일치해야 하며, 그렇지 않으면 인증이 거부됩니다.
지원되는 참조 URL 형식의 예시는 다음과 같습니다.
- https://www.example.com/pages
- https://www.example.com/pages/index.html
다음을 클릭합니다.
권한을 할당하여 자격 증명을 통해 앱에서 수행할 수 있는 동작을 선택하고 다음을 클릭합니다.
사용 가능한 권한의 목록은 ArcGIS Location Platform 구독이 있는지 여부 및 기관에서의 권한에 따라 달라집니다. 계정이 소유하지 않은 권한은 할당할 수 없습니다.
권한 유형에 대한 자세한 내용은 Esri 개발자 도움말의 보안 및 인증 가이드를 참조하세요.
항목 찾아보기를 클릭하여 임베드된 자격 증명을 통해 접근할 수 있는 항목을 선택하고 항목 추가를 클릭합니다.
또는 건너뛰기를 클릭할 수 있습니다.
제목을 입력합니다.
내 콘텐츠에서 항목을 저장할 폴더를 선택합니다.
또는 메뉴에서 새 폴더 생성을 선택하고 폴더 이름을 입력하여 항목을 새 폴더에 저장할 수 있습니다.
폴더 이름에는 4바이트 유니코드 문자를 포함할 수 없습니다.
기관에 콘텐츠 범주가 설정되어 있는 경우 범주 할당을 클릭한 다음 다른 사용자가 항목을 손쉽게 찾을 수 있도록 최대 20개의 범주를 선택합니다.
범주 이름을 입력하여 범주 목록의 범위를 좁힐 수도 있습니다.
필요한 경우 항목을 설명하는 태그를 입력합니다.
용어를 쉼표로 구분합니다. 예를 들어 Federal land는 하나의 태그로 구분되지만 Federal, land는 두 개의 태그로 간주됩니다.
입력할 때 표시되는 추천 태그 중 하나를 선택할 수 있습니다. 추천 태그는 사용자가 이전에 추가한 태그에서 생성됩니다.
필요한 경우 앱에 대한 간단한 설명을 추가합니다.
다음을 클릭합니다.
자격 증명 요약을 검토합니다. 설정을 변경하려면 뒤로를 클릭하여 항목을 생성하기 전에 변경합니다.
자격 증명에 대한 개인 권한을 부여한 경우 보안 승인서 옆에 있는 체크 박스를 선택하여 해당 승인서를 읽고 동의했음을 확인한 후 다음을 클릭합니다.
API 키를 즉시 생성할지 아니면 나중에 생성할지를 선택하고 다음을 클릭합니다.
API 키는 생성되는 즉시 복사해야 합니다.
- API 키를 생성하고 항목 세부정보 페이지로 이동합니다. 키를 복사하고 저장할 준비가 되었습니다. 옵션을 클릭한 경우 다음을 클릭하면 API 키 생성 팝업이 나타납니다. 복사 버튼을 클릭하여 키를 복사합니다. 보안 문서에 키를 붙여넣습니다. 완료하면 팝업을 닫습니다.
- 항목 세부정보 페이지로 이동합니다. 나중에 API 키를 생성하겠습니다. 옵션을 선택하면 자격 증명 항목 페이지가 나타납니다. 다음을 클릭하면 항목 페이지가 나타납니다. 항목 페이지의 설정 탭에서 API 키를 생성할 수 있습니다.

앱이 콘텐츠에 추가되며 앱의 항목 페이지가 나타납니다. 항목 페이지에, 그리고 콘텐츠 페이지 또는 항목 미리 보기 창에서 항목을 볼 때 앱에 API 키 자격 증명이 임베드되었다는 것을 나타내는 배지가 표시됩니다. 항목 페이지의 오버뷰 탭에서 이 배지는 자격 증명에 개인 권한이 포함되어 있는지 아니면 표준 권한만 포함되어 있는지를 나타냅니다.