대상: 이 문서는 현재 iSAMS 통합 기능을 사용 중인 SchoolsBuddy 기존 고객에게 적용됩니다.
iSAMS 모든 배치 API를 OAuth 2.0으로 업그레이드하고 있습니다. OAuth 2.0은 향상된 데이터 보안, 연결 안정성 및 학교 데이터에 대한 더 나은 액세스 제어를 제공하는 최신 업계 표준입니다.
향후 iSAMS 시스템 다운 기간 동안 데이터 동기화가 중단 없이 계속되도록 하려면 2026년 10월 14일 이전에 아래 단계를 완료하십시오.
파트 1: iSAMS 에서 OAuth 2.0 클라이언트 시크릿 생성하기
- 관리자 권한으로 iSAMS 에 로그인하고 제어판을 여십시오.
- API 서비스 관리자를 선택하십시오.
- 일괄 API 키 관리(Manage Batch API Keys)를 선택하세요.
- SchoolsBuddy 용 기존 배치 API 키를 찾고 오른쪽에 있는 금색 열쇠 아이콘을 클릭하세요.
- 이 API 키에 대한 새 비밀 키를 생성할지 묻는 팝업 창에서 '예'를 클릭하세요.
- 클라이언트 ID와 클라이언트 시크릿이 표시됩니다.
⚠️ 중요: 2부를 완료할 때까지 이 창이나 브라우저 탭을 닫지 마세요!
파트 2: SchoolsBuddy 에 자격 증명을 추가하세요
SchoolsBuddy 에 슈퍼 관리자 계정으로 로그인하세요.
- 설정으로 이동
- 시작하기 > 데이터 통합
- 가져오기 활성화 토글이 켜짐(녹색)으로 설정되어 있는지 확인하십시오.
학교의 iSAMS 호스팅 URL이 정확한지 확인하십시오.
API 키 섹션으로 스크롤하십시오(모든 활성 데이터 엔티티는 이미 활성화되어 있어야 합니다).
고객 ID를 확인하세요(이 필드는 이미 입력되어 있어야 합니다).
1부(6단계)에서 생성한 클라이언트 암호를 해당 필드에 붙여넣으세요.
상위 가져오기 필터: 이러한 필터는 초기 온보딩 과정에서 학교의 선호도에 따라 구성되었습니다. 학교의 가져오기 요구 사항이 변경되지 않는 한 이 설정을 그대로 두십시오.
- 직원 가져오기 필터: 학교 이메일 도메인이 이미 여기에 추가되었습니다. 직원 도메인을 업데이트하는 경우가 아니면 이 섹션을 변경하지 마십시오.
- 연말 처리: 현재로서는 이 부분을 변경하실 필요가 없습니다. 연간 학기 이월이 완료되면 [ iSAMS 연말 처리 안내] 를 참조하시기 바랍니다.
- 페이지 하단으로 스크롤하여 '변경 사항 저장'을 클릭하세요.
iSAMS 연동 기능이 업데이트되어 곧 있을 OAuth 2.0 마이그레이션을 위한 준비가 완료되었습니다!
🚀 새로운 기능: 수동 트리거 iSAMS 가져오기
이제 SchoolsBuddy 에서 iSAMS 의 데이터를 필요에 따라 수동으로 가져올 수 있습니다! iSAMS 에서 긴급하게 변경 사항을 적용하여 SchoolsBuddy 에 즉시 반영해야 하는 경우 이 기능을 사용하세요.
설정 > 시작하기 > 데이터 통합 으로 이동하세요.
페이지 하단의 '가져오기 실행' 버튼을 클릭하세요.
⏱️ 수동 가져오기에 대한 중요 참고 사항:
실행 횟수 제한: ' 가져오기 실행' 버튼은 5분 에 한 번만 실행할 수 있습니다.
처리 시간: 학교 규모 및 데이터 세트에 따라 가져오기 완료까지 10분에서 20분이 소요될 수 있습니다.
iSAMS 피드 새로 고침 지연 시간: SchoolsBuddy 에 업데이트 내용이 표시되려면 먼저 iSAMS API 피드에 변경 사항이 반영되어야 합니다. iSAMS 인스턴스에서 데이터를 직접 업데이트하더라도 SchoolsBuddy 에서 해당 피드를 즉시 반영하는 것은 아닙니다. 가져오기를 실행하기 전에 iSAMS 피드가 새로 고쳐질 때까지 기다려 주십시오.
-
유용한 팁: API 키 캐시 만료 시간을 단축하면 iSAMS 피드 업데이트 빈도를 줄일 수 있습니다. (기본값: 24시간)