통합 로그인

security365 통합 로그인

최초 로그인 시 통합로그인 UI 가 나타납니다.
통합로그인 사용자가 아닌 경우 최초 로그인 시 통합로그인 UI를 닫으면 Document Security 로그인 UI 가 나타납니다.

SHIELD ID 로그인 화면은 DS365.Core.json 설정으로 아래와 같이 적용 가능합니다.

DS_MIP_INIT 항목 설정

"mode" 지정은 "webView" 또는 "msedgeApp" 로 지정합니다.
로그인 유형인 "webView", "msedgeApp" 에서 사용할 옵션은 해당 키값의 항목을 설정합니다.

"title" 지정은 통합로그인 UI 에 표시되는 문자열을 지정합니다. 일반적으로 Security365 로 표시되나, 커스터마이징을 통해서 통합로그인 CI 및 타이틀을 변경할 경우 해당 파일도 같이 적용해야 합니다.

//DS365.Core.json 설정 예제
{
  "login": {
    "port": "28080",
    "waitMinTime": "0",
    "mode": "msedgeApp",
    "title": "Security365,SOFTCAMP,Shieldrm,Login",
    "webView": {
      "idPwEveryTime": "none",
      "topMost": "none"
    },
    "msedgeApp": {
      "fullScreen": "none",
      "idPwEveryTime": "none",
      "topMost": "none"
    }
  }
}

사용자 화면	내용	비고
	창 모드	login.mode : "msedgeApp"
	전체화면 모드 주 모니터의 전체화면으로 발현	login.mode : "msedgeApp", "login.fullScreen" : "use"

security365 계정 연동

SHIELD ID 로그인 시 해당 계정에 등록된 문서보안 계정(SCI서버) 정보가 없을 경우 아래와 같이 계정 연결 진행됩니다.
각 안내화면은 3분 타임아웃이 적용되며, 3분간 해당 안내창을 닫지 않을 경우 자동으로 닫히고 다음 단계로 이동 합니다.

사용자 화면	내용	비고
	통합 로그인 (SHIELD ID)	microsoft id/pw 인증
	통합로그인 진행 후 로그인 완료된 SHIELD ID와 연동된 sci 계정이 없을 경우 안내 창 표시	연결된 정보가 없을 경우 SHIELD ID 인증에 성공한 아이디 아래 항목 시도 1. 전체 계정 정보로 sci 서버에 사용자 체크 2. 도메인 정보 제거 후 sci 서버에 사용자 체크
	문서보안 로그인 절차에 따름	문서보안 로그인이 진행 자동로그인/SSO 등이 없는 경우 문서보안 로그인 화면 출력되며, 문서보안 로그인 완료 후 아래 화면으로 이동
	SHIELD ID 와 문서보안 인증에 성공한 계정 정보 출력 및 연결 안내 화면	로그인이 완료된 후에 문서보안 계정과 이미 발급된 토큰의 SHIELD ID를 비교해서 다르면, 기존 토큰을 삭제하고 SHIELD ID의 연동된 계정을 현재 로그인한 문서보안 계정으로 등록 시 발생 가능성 e.g. 회의실 같이 한 장비에 여러 사용자가 로그인하는 경우
	SHIELD ID에 sci 사용자 등록 완료 안내 화면

SHIELD ID 통합 로그인 페이지 커스터마이징

사이트용 화면을 설정하기 위해서는 idp 서비스에서 관련 정책 설정 필요
- 참고 | ⚠️ 해당 자료는 접근에 제한이 있는 자료임을 알려드립니다.
DS_MIP_INIT 정책 중 extra 정책의 값 설정 필요
정책 예시

{
  "s365_url": "https://devlogin.softcamp.co.kr/",
  "s365_app_id": "4e3b53b2-a18c-4d78-8de1-b9fcada4077c",
  "s365_app_name": "shieldrm-svc",
  "s365_app_secret": "JyktLCInJ------------------------JycsJyQ",
  "s365_log_url": "https://log.security365.com/log/event",
  "shieldrm_url": "https://ssevtr.softcamp.co.kr/",
  "extra": "3CJ55MSE-xLO7Sxt4-qUBKzbcs-XP2cgGEq",
  "tid" : "4d615af9-1d04-4bcc-8e6f-c6b6fe3110dd",
  "runMode": "s365"
}

통합 로그인 화면 팝업 On/Off 설정

정보

통합 로그인 화면 팝업을 환경설정 또는 커스텀 정책으로 On/Off 할 수 있는 기능을 설명합니다.

개요

통합 로그인 화면 팝업을 환경설정 또는 커스텀 정책으로 on/off 할 수 있는 기능입니다.

설명

'SHIELD DRM 미사용' 여부는 사용자가 직접 선택할 수 있는 항목이며, 기본값은 0입니다.
DS_SDSENV_NOT_USE_SHIELD_DRM 정책은 관리자가 중앙에서 이 옵션을 제어하기 위해 사용하는 정책입니다.
해당 정책을 사용하면, 환경설정 화면의 'SHIELD DRM 미사용' 체크박스는 비활성화되며, 사용자가 해당 옵션을 변경할 수 없습니다.
체크 여부는 관리자가 설정한 정책값에 따라 강제로 적용되며, 사용자 설정은 무시됩니다.

ID	DS_SDSENV_NOT_USE_SHIELD_DRM
TYPE	Check On/Off
설명	SHIELD DRM 사용 유무 (1: 사용 안함, 0: 사용함)
정책 값	1 (혹은 Check)
scsc	DS_SDSENV_NOT_USE_SHIELD_DRM.scsc

적용 방법

모듈 패치
커스텀 정책 설정 및 정책 받아오기

제약 사항

Shield Drm 사용 정책 값에서 미사용 정책값으로 변경하는 경우 시스템 재부팅이 진행되어야 관련 모듈이 정상적으로 종료되어 기능이 off됩니다.
미사용에서 사용으로 변경하는 경우에도 재부팅이 없이도 동작이 가능하나 가급적 재부팅을 권장합니다.
환경 설정에서 해당 값 변경 시 시스템 재부팅이 필요하다는 사용자 안내 문구가 나옵니다.-

SHIELD ID 사용자 계정 비활성화 시 DS6 인증 차단 및 로그아웃

정보

SHIELD ID 의 사용자 계정이 비활성화된 경우, DS6 클라이언트에서 SHIELD ID 인증 실패되며 이때 기존 SCI 서버 인증도 차단(로그인 실패처리)하는 기능입니다.

개요

SHIELD ID에서 사용자 계정이 비활성화되면, DS6 클라이언트에서 해당 사용자의 인증을 차단하고 알림 메세지 표시 후 문서보안 로그아웃 처리하는 기능입니다.

설명

security365 사용자 비활성화
비활성화 된 사용자는 다음의 두 상황에서 따라 차단 동작이 발생합니다.
- 문서보안 로그인 상태
  - ztcap 정책으로 평가되는 동작에 의해 ( Ex 우클릭 MIP 로 문서변환, MIP->Drm문서변환 등) 비활성화 된 사용자로 응답 받을 경우 알림 메세지창 발현 및 문서보안 로그아웃 상태가 됨.
- 문서보안 미 로그인 상태
  - DS_MIP_INIT 정책의 Runmode sso 를 사용하는 경우에 한정하여 s365 인증 받기 전에 사용자 ShieldID로 조회하여 비활성화 사용자의 경우 로그인 직후 알림 메세지창 발현 및 다시 로그아웃 상태가 됨.
  - sso가 아닌 다른 Runmode 정책 값의 경우 현재 지원 불가 ( 사유에 대해서는 아래 제약사항 참고 )

적용 방법

모듈 패치

제약 사항

DS_MIP_INIT 정책의 Runmode sso가 아닌 다른 Runmode 사용 시 ( s365, appauth, aad, ds ) 아래 사유로 비활성화된 ShieldID 사용자의 로그인 차단 및 로그인 후 바로 로그아웃 기능은 동작이 불가함.
- s365, ds의 경우 통합 로그인 창을 사용하여 s365인증을 진행하는 데 사용자의 shieldID가 브라우저 및 securiy365 front 단에서 인증이 동작하므로 DS 6.0 클라이언트 입장에서 ShieldID를 얻어올 방법이 없음. ( ShieldID가 없으면 비활성화 여부 확인 불가 )
- appauth의 경우 개별 사용자의 shieldId 기반이 아닌 sheildrm svc 앱 기반으로 동작하므로 기능이 무의미함.
- aad의 경우 현재는 테넌트id로 인증 후 토큰에서 shieldID를 구해 올 수 있으나, 현재 구조에서는 미지원입니다.
MIP 해제의 경우 기존에 ztcap으로 해제 여부를 판단하는 로직이 존재하지 않기 때문에 지금 구조에서는 이 기능이 적용되지 않습니다.

알림 메세지

사용자가 비활성화 될 경우 아래의 알림 메세지와 함께 문서보안 로그아웃 처리됨.

PKCE 인증 (공용 클라이언트 로그인)

정보

요약: 정책에 앱 시크릿(s365_app_id)이 없으면 자동으로 PKCE(브라우저) 로그인으로 동작합니다. 발급된 토큰은 PC 자격 증명 관리자에 안전하게 보관되어, 만료 전에는 오프라인에서도 사용되고 만료 시 자동 갱신됩니다.

개요

DS6의 Security365 로그인이 배포 환경에 따라 PKCE(공용 클라이언트) 방식으로 자동 동작하도록 지원하는 기능입니다.

앱 시크릿(자격 증명)을 배포할 수 없는 환경에서도 브라우저 로그인만으로 사용자 인증을 마치고, 이후 문서 보안 등급 지정·MIP 보호 등 Security365 기능을 사용할 수 있습니다.

사용자는 인증 방식을 직접 고르지 않습니다. 관리자 정책 설정값에 의해 자동으로 방식이 결정되며, 인증 이후에는 저장된 토큰이 유효한 동안 재로그인 없이 기능을 사용합니다.

본 기능이 필요한 이유

기존 Confidential 방식은 앱 시크릿(s365_app_id)이 정책에 배포되어야 동작합니다. 시크릿을 배포하기 어려운 공용 클라이언트 환경에서는 로그인 자체가 불가했습니다.
또한 인증 정보가 없는 상태에서 MIP 변환(등급 변경·보호)을 시도할 때 로그인 창이 뜨지 않아 작업이 진행되지 않는 사례가 있었습니다.
본 기능은 PKCE 표준(공용 클라이언트) 로그인을 추가하고, 미인증 상태의 변환 요청에서 재인증 창이 정상 출력되도록 정비했습니다.

동작 방식

정책의 앱 시크릿(s365_app_id) 유무로 PKCE / Confidential 을 자동 분기하고, PKCE 에서는 브라우저 로그인으로 사용자 토큰을 발급받아 자격 증명 관리자에 보관하며, 만료 시 자동 갱신 또는 재로그인으로 이어집니다.

적용 범위 / 진입점

진입점	동작
Security365 기능 최초 사용	브라우저 로그인 창 출력 → 토큰 발급
파일 우클릭 → 보안 등급 변경	저장 토큰 사용, 필요 시 재인증(온라인 확인 후)
파일 우클릭 → MIP 보호/해제	저장 토큰 사용, 필요 시 재인증
문서보안(DS) 미로그인 상태	MIP 우클릭 메뉴 자체가 노출되지 않음 — 제약사항 참조

토큰 수명과 재인증

DS6 는 두 종류의 토큰을 사용합니다. 사용자 토큰은 작업 수행에, 리프레시 토큰은 액세스 토큰 재발급에 쓰입니다.

상황	동작	사용자 개입
R1. 액세스 토큰 만료	리프레시 토큰으로 서버에 조용히 자동 재발급 (온라인 필요)	없음 (로그인 창 미출력)
R2. 리프레시 토큰 만료·무효	작업 중이면 브라우저 로그인 창 자동 재출력, 백그라운드면 실행 시점 재인증	재로그인
R3. 테넌트(회사) 변경	저장 토큰 폐기 후 재로그인 요구 (교차 테넌트 오용 방지)	재로그인
R4. 계정 비활성 (`User is not enabled`)	로그인 창을 반복 출력하지 않고 즉시 실패	관리자에게 계정 활성화 요청

정책 / 설정

설정 항목	위치	값 / 설명	필수
`s365_app_id` `s365_app_secret`	서버 정책 `DS_MIP_INIT`	비우면 PKCE, 채우면 Confidential	방식 결정
`s365_pkce_appid`	서버 정책 `DS_MIP_INIT`	PKCE 클라이언트 ID (최우선)	권장
`login.pkce-clientId`	`DS365.Core.json`	PKCE 기본 클라이언트 ID. `s365_pkce_appid` 미설정 시 사용. 재배포 없이 환경별 교체 가능	`s365_pkce_appid` 미사용 시 필수

경고

주의: s365_pkce_appid(서버 정책)와 login.pkce-clientId(설정 파일)가 모두 비면 내장 기본값이 없어 로그인이 불가합니다. 둘 중 하나는 반드시 설정해야 합니다.

설정 파일 예시 (DS365.Core.json):

{
  "login": {
    "pkce-clientId": "9586b6e7-7f17-4d18-871b-051705bd5eb6",
    "title": "SOFTCAMP,Security365"
  }
}

동작 시나리오

상황	결과
최초 사용 (온라인)	브라우저 로그인 → 토큰 발급·저장
저장 토큰 유효	통신 없이 즉시 사용 (오프라인 포함)
액세스 토큰 만료 (온라인)	자동 갱신, 창 미출력
액세스 토큰 만료 (오프라인)	갱신 불가 → 온라인 필요
리프레시 토큰 만료 (온라인)	브라우저 재로그인
DS 미로그인 / 오프라인 상태의 재인증 필요	네트워크 오류 안내, 창 미출력
계정 비활성	즉시 실패, 관리자 조치 필요

제약 사항

#	제약	상세
C1	최초 사용·토큰 갱신 시 온라인 필요	브라우저 로그인·자동 갱신에 서버 통신 필요
C2	유효 토큰 보유 시 오프라인 사용 가능	저장 토큰 만료 전에는 오프라인 동작
C3	리프레시 토큰 만료 시 재로그인	자동 갱신 불가 → 브라우저 재인증
C4	테넌트 변경 시 재로그인	회사 불일치 시 저장 토큰 폐기
C5	계정 비활성 시 관리자 조치	재인증 창 미출력, 계정 활성화 필요
C6	DS 로그인 전제	MIP 변환 메뉴는 문서보안 로그인 상태에서만 노출
C7	`login.title` 설정 필요 (운영)	미설정 시 로그인 창 미종료·약 10초 후 취소
C8	`shieldrm-svc` 서버 등록 필요	미등록 시 등급 조회·MIP 차단
C9	PKCE 클라이언트 ID 최소 1곳 설정 필수	`s365_pkce_appid` 또는 `login.pkce-clientId` 중 하나 이상, 없으면 로그인 불가

통합 로그인

security365 통합 로그인

DS_MIP_INIT 항목 설정

security365 계정 연동

SHIELD ID 통합 로그인 페이지 커스터마이징

통합 로그인 화면 팝업 On/Off 설정

개요

설명

관련 커스텀 정책

적용 방법

제약 사항

SHIELD ID 사용자 계정 비활성화 시 DS6 인증 차단 및 로그아웃

개요

설명

적용 방법

제약 사항

알림 메세지

관련 커스텀 정책

PKCE 인증 (공용 클라이언트 로그인)

개요

본 기능이 필요한 이유

동작 방식

적용 범위 / 진입점

토큰 수명과 재인증

정책 / 설정

동작 시나리오

제약 사항

security365 통합 로그인​

DS_MIP_INIT 항목 설정​

security365 계정 연동​

SHIELD ID 통합 로그인 페이지 커스터마이징​

통합 로그인 화면 팝업 On/Off 설정​

개요​

설명​

관련 커스텀 정책​

적용 방법​

제약 사항​

SHIELD ID 사용자 계정 비활성화 시 DS6 인증 차단 및 로그아웃​

개요​

설명​

적용 방법​

제약 사항​

알림 메세지​

관련 커스텀 정책​

PKCE 인증 (공용 클라이언트 로그인)​

개요​

본 기능이 필요한 이유​

동작 방식​

적용 범위 / 진입점​

토큰 수명과 재인증​

정책 / 설정​

동작 시나리오​

제약 사항​

security365 통합 로그인

DS_MIP_INIT 항목 설정

security365 계정 연동

SHIELD ID 통합 로그인 페이지 커스터마이징

통합 로그인 화면 팝업 On/Off 설정

개요

설명

관련 커스텀 정책

적용 방법

제약 사항

SHIELD ID 사용자 계정 비활성화 시 DS6 인증 차단 및 로그아웃

개요

설명

적용 방법

제약 사항

알림 메세지

관련 커스텀 정책

PKCE 인증 (공용 클라이언트 로그인)

개요

본 기능이 필요한 이유

동작 방식

적용 범위 / 진입점

토큰 수명과 재인증

정책 / 설정

동작 시나리오

제약 사항