포털 검사기 구성 문제

이 문서에서는 구성 문제와 관련된 포털 검사기 진단 결과 및 일반적인 문제를 해결하는 방법에 대해 알아봅니다.

기본 양식, 목록 및 고급 양식 단계에 대한 익명 액세스

다음 문제는 Dataverse 지원 구성 요소에 대한 테이블 권한 구성과 관련이 있습니다.

기본/고급 양식 및 목록에 대한 익명 액세스

포털의 기본 양식, 고급 양식 및 목록은 목록 보안 및 양식 보안에 설명된 대로 이러한 컨트롤을 생성하거나 수정하는 동안 테이블 권한 활성화 확인란을 선택하지 않으면 테이블 권한 시행에서 제외될 수 있습니다.

이 방법은 포털 개발 중에 구성을 빠르게 테스트하는 데 유용하지만 포털에서 목록 및 양식을 보호하지 않으면 데이터에 대한 무단 액세스를 포함하여 의도하지 않은 결과가 발생할 수 있습니다. 이 방법은 안전한 개발 또는 테스트 환경 외부에서 사용하지 않는 것이 좋습니다.

목록/기본 양식에 대한 이 문제를 해결하는 방법:

1.  포털 관리 앱을 엽니다.

2. 적절한 경우 왼쪽 창에서 목록 또는 기본 양식을 선택합니다.

3. 포털 검사기 규칙에 언급된 레코드를 찾습니다.

4. 목록 또는 기본 양식에 대한 "테이블 권한 활성화" 속성을 업데이트하세요.

고급 양식에 대한 이 문제를 해결하는 방법:

중요

포털 검사기 규칙은 유사한 구성을 가질 수 있는 고급 양식 단계를 언급하지 않습니다.

1.  포털 관리 앱을 엽니다.

2. 왼쪽 창에서 고급 양식을 선택합니다.

3. 각 고급 양식을 열고 고급 양식 단계로 이동합니다.

4. 각 단계를 거쳐 테이블 권한 사용 속성을 사용하도록 업데이트합니다.

이렇게 변경되면 모든 사용자가 이러한 구성 요소에 액세스할 수 있도록 적절한 테이블 권한을 생성하고 적절한 웹 역할에 할당해야 합니다.

참고

테이블 권한을 사용 중지하는 이 방법은 곧 더 이상 사용되지 않습니다. 따라서 사용해서는 안 됩니다. 적절한 테이블 권한과 웹 역할 설정을 사용하여 대신 사용자에게 모든 데이터에 대한 액세스 권한을 제공합니다. 자세한 정보: 새 포털의 양식 및 목록에 대한 테이블 권한 변경

OData 피드에 대한 익명 액세스 가능

참고

릴리스 9.3.7.x를 시작으로 OData 피드가 활성화된 모든 포털(신규 또는 기존)의 목록은 이 목록의 피드가 작동하려면 적절한 테이블 권한 설정이 필요합니다.

포털의 목록 구성 요소는 목록에서 OData 피드를 활성화하여 OData 피드에 대해 활성화할 수 있습니다.

포털에서 활성화된 익명 OData 피드를 찾는 방법:

1. 포털에 인증하지 않고 InPrivate 모드에서 '{포털 URL}/_odata'(예: https://contoso.powerappsportals.com/_odata)로 이동합니다.

2. UI에는 포털에서 활성화된 모든 OData 피드 목록이 표시됩니다.

   

   참고

   이 페이지의 OData 피드 목록은 보안 구성에 따라 익명으로 제공될 수 있습니다. 다음 단계는 이러한 피드의 익명 액세스를 확인하는 데 도움이 됩니다.

3. 아래에서 컬렉션 href 값이 강조 표시된 URL 형식 {포털 URL}/_odata/{컬렉션 href 값}(예: https://contoso.powerappsportals.com/_odata/accounts)으로 이동하여 각 OData 피드로 이동합니다.

   

4. OData 필드를 익명으로 사용할 수 있는 경우 HTTP 200 응답과 함께 데이터를 반환합니다. 피드가 익명으로 활성화되지 않은 경우 "엔티티 세트 이름이 '{테이브 세트 이름}'인 OData에 대한 액세스가 거부되었습니다."라는 메시지와 함께 HTTP 403 응답을 반환합니다.

실수로 사이트의 OData 피드에 대한 익명 액세스를 활성화한 경우 다음 가능성 중 하나 때문일 수 있습니다.

• 목록 보안에 설명한 바와 같이 OData 피드를 활성화하는 목록은 보안되지 않습니다.

  • 이 문제를 해결하려면 목록 보안에 설명된 대로 목록을 보호하고 적절한 테이블 권한 및 웹 역할을 사용하여 사용자에게 액세스 권한을 제공하십시오.

  • 위에서 언급한 문서에서 설명한 것처럼 포털 검사기를 통해 보안되지 않은 목록도 찾을 수 있습니다.

• 목록을 보호하고 목록에 사용된 테이블에 대한 적절한 테이블 권한을 생성하고 해당 테이블 권한을 익명 웹 역할에 할당합니다.

  • 이 문제를 해결하려면 의도한 데이터만 익명으로 사용할 수 있도록 익명 웹 역할에 할당된 테이블 권한이 업데이트되었는지 확인하세요.

순환 상위 웹 페이지

이 문제는 웹 페이지가 자신을 상위 페이지로 참조할 때 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 자신을 참조하지 않는 올바른 웹 페이지 레코드를 가리키도록 상위 페이지 필드를 업데이트합니다.

CMS 보안 검사에 실패한 테이블 목록

이 문제를 해결하려면 테이블에 적절한 검색 페이지가 있는지 확인하세요.

검색 결과에 잘못된 URL이 있는 테이블 목록

이 문제를 해결하려면 테이블에 적절한 보안 권한이 있는지 확인하세요.

정적 리소스(CSS/JS)를 비동기적으로 로드

포털 구현에서 작업할 때 페이지의 HTML을 완전히 관리한다는 것을 이해하는 것이 중요합니다. 즉, 웹 페이지의 클라이언트측 성능이 영향을 받지 않도록 표준 웹 개발 관행을 따라야 합니다.

웹 페이지에서 성능 문제의 가장 일반적인 원인 중 하나는 페이지 로드 시 많은 정적 리소스(CSS/JS)를 동기적으로 로드하는 것입니다. 포털에서 웹 파일을 홈 페이지에 직접 연결할 때마다 생성된 HTML에 종속성이 생성됩니다. 즉, 웹 파일은 항상 홈 페이지와 함께 로드됩니다. 많은 수의 CSS/JS 파일의 동기식 로드는 웹 페이지에 대한 긴 클라이언트측 처리 시간으로 이어질 수 있습니다.

이를 피하려면 다음을 수행합니다.

1. 홈 페이지에 웹 파일이 필요하지 않은 경우 상위 페이지가 홈으로 설정되어 있지 않은지 확인하고 위의 섹션에서 설명한 단계에 따라 요청 시 로드해야 합니다.
2. 모든 페이지에서 요청 시 JavaScript 파일을 로드하는 동안 <async> 또는 <defer> HTML 특성을 사용하여 파일을 비동기적으로 로드합니다.
3. 요청 시 CSS 파일을 로드하는 동안 <preload> HTML 특성(https://www.w3.org/TR/preload/) 또는 사전 로드가 아직 모든 브라우저에서 지원되지 않으므로 JavaScript 기반 접근 방식을 사용할 수 있습니다.

활성 웹 페이지의 부모 페이지가 비활성 상태입니다.

이 문제는 상위 웹 페이지 레코드가 비활성일 때 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 상위 페이지 레코드를 선택하여 레코드로 이동합니다.
5. 명령 모음에서 활성화를 선택합니다.

포털에 액세스할 수 없습니다

이 문제는 사이트의 인증 인증서를 갱신해야 할 때 발생할 수 있습니다.

포털이 생성되면 새로운 인증 키가 생성됩니다. 포털은 이 인증 키를 사용하여 Microsoft Dataverse 환경에 연결합니다. 인증 키가 만료되면 포털 사용자에게 포털에 액세스할 수 없다는 메시지가 표시됩니다.

이 문제를 해결하려면 이 사이트에 대해 인증 키를 갱신하십시오.

게시된 상태 구성

다음 문제는 게시 상태와 관련이 있습니다.

이 웹 사이트에 게시된 상태를 사용할 수 없습니다.

문제를 해결하려면 게시 상태 게시됨이 있고 활성 상태인지 확인하세요.

게시된 상태가 표시되지 않음

문제를 해결하려면 게시 상태 게시됨에 표시 여부 확인란이 선택되었는지 확인합니다.

사이트 마커

다음 문제는 사이트 마커와 관련이 있습니다.

홈 사이트 마커 구성

다음 문제는 사이트 마커 및 홈 웹 페이지와 관련이 있습니다.

활성 홈 사이트 마커는 이 포털에 사용할 수 없습니다.

이 문제는 포털 구성에서 홈 사이트 마커를 사용할 수 없을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 다음 값으로 새 사이트 마커를 만듭니다.
   • 이름: 홈
   • 웹 사이트: 포털 호스트의 웹 사이트를 선택하십시오.
   • 페이지: 포털의 홈 페이지로 설정된 웹 페이지 기록을 선택합니다.

홈 사이트 마커가 어떤 웹 페이지도 가리키지 않습니다.

이 문제는 홈 사이트 마커를 사용할 수 있지만 웹 페이지를 가리키고 있지 않을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 홈 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 홈 페이지를 가리도록 페이지 필드를 업데이트합니다.

홈 사이트 마커가 비활성 웹 페이지를 가리키고 있습니다.

이 문제는 홈 사이트 마커를 사용할 수 있지만 비활성화된 웹 페이지를 가리키고 있을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 홈 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 홈 페이지를 가리도록 페이지 필드를 업데이트합니다.

홈 사이트 마커가 포털의 홈 페이지를 가리키지 않습니다.

이 문제는 홈 사이트 마커를 사용할 수 있지만 포털의 홈 페이지가 아닌 웹 페이지를 가리키고 있을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 홈 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 홈 페이지를 가리도록 페이지 필드를 업데이트합니다.

프로필 사이트 마커 구성

다음 문제는 프로필 페이지에 대한 사이트 마커 구성과 관련이 있습니다.

활성 프로필 사이트 마커는 이 포털에 사용할 수 없습니다.

이 문제는 포털 구성에서 프로필 사이트 마커를 사용할 수 없을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 다음 값으로 새 사이트 마커를 만듭니다.
   • 이름: 프로필
   • 웹 사이트: 포털 호스트의 웹 사이트를 선택하십시오.
   • 페이지: 포털의 프로필 페이지로 설정된 웹 페이지 레코드를 선택하십시오.

프로필 사이트 마커가 어떤 웹 페이지도 가리키지 않습니다.

이 문제는 프로필 사이트 마커를 사용할 수 있지만 웹 페이지를 가리키고 있지 않을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 프로필 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 프로필 페이지를 가리도록 페이지 필드를 업데이트합니다.

프로필 사이트 마커가 비활성 웹 페이지를 가리키고 있습니다.

이 문제는 프로필 사이트 마커를 사용할 수 있지만 비활성화된 웹 페이지를 가리키고 있을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 프로필 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 프로필 페이지를 가리도록 페이지 필드를 업데이트합니다.

페이지 없음 사이트 마커 구성

다음 문제는 페이지를 찾을 수 없음 웹 페이지에 대한 사이트 마커 구성과 관련이 있습니다.

활성 페이지 없음 사이트 마커는 이 포털에 사용할 수 없습니다.

이 문제는 포털 구성에서 페이지 없음 사이트 마커를 사용할 수 없을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 다음 값으로 새 사이트 마커를 만듭니다.
   • 이름: 페이지 없음
   • 웹 사이트: 포털 호스트의 웹 사이트를 선택하십시오.
   • 페이지: 포털의 '페이지 없음' 페이지로 설정된 웹 페이지 레코드를 선택하십시오.

페이지 없음 사이트 마커가 어떤 웹 페이지도 가리키지 않습니다.

이 문제는 페이지 없음 사이트 마커를 사용할 수 있지만 웹 페이지를 가리키고 있지 않을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 페이지 없음 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 '페이지 없음' 페이지를 가리도록 페이지 필드를 업데이트합니다.

페이지 없음 사이트 마커가 비활성 웹 페이지를 가리킴

이 문제는 페이지 없음 사이트 마커를 사용할 수 있지만 비활성화된 웹 페이지를 가리키고 있을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 페이지 없음 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 '페이지 없음' 페이지를 가리도록 페이지 필드를 업데이트합니다.

액세스 거부 사이트 마커 구성

다음 문제는 액세스 거부됨 페이지에 대한 사이트 마커 구성과 관련이 있습니다.

활성 액세스 거부 사이트 마커는 이 포털에 사용할 수 없습니다.

이 문제는 포털 구성에서 액세스 거부됨 사이트 마커를 사용할 수 없을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 다음 값으로 새 사이트 마커를 만듭니다.
   • 이름: 액세스 거부
   • 웹 사이트: 포털 호스트의 웹 사이트를 선택하십시오.
   • 페이지: 포털의 '액세스 거부' 페이지로 설정된 웹 페이지 레코드를 선택하십시오.

액세스 거부 사이트 마커가 어떤 웹 페이지도 가리키지 않습니다.

이 문제는 액세스 거부됨 사이트 마커를 사용할 수 있지만 웹 페이지를 가리키고 있지 않을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 액세스 거부 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 '액세스 거부' 페이지를 가리도록 페이지 필드를 업데이트합니다.

액세스 거부 사이트 마커가 비활성 웹 페이지를 가리키고 있습니다.

이 문제는 액세스 거부 사이트 마커를 사용할 수 있지만 비활성화된 웹 페이지를 가리키고 있을 때 발생합니다(루트 또는 콘텐츠 페이지가 비활성화될 수 있음). 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 액세스 거부 사이트 마커 레코드를 찾습니다.
4. 포털의 활성 '액세스 거부' 페이지를 가리도록 페이지 필드를 업데이트합니다.

검색 사이트 표식 가용성

다음 문제는 사이트 검색 페이지에 대한 사이트 마커 구성과 관련이 있습니다.

활성 검색 사이트 표식은 이 포털에 사용할 수 없습니다.

이 문제는 포털 구성에서 검색 사이트 표식을 사용할 수 없을 때 발생합니다. 이 문제를 해결하려면

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 사이트 마커를 선택합니다.
3. 검색이라는 사이트 표식을 사용할 수 있고 비활성화된 경우, 그것을 정품 인증합니다.
4. 사용할 수 없는 경우 다음 값으로 새 사이트 표식을 만듭니다:
   • 이름: 검색
   • 웹 사이트: 포털 호스트의 웹 사이트를 선택하십시오.
   • 페이지: 포털의 검색 페이지로 설정된 웹페이지 레코드를 선택합니다.
5. 저장하고 닫기를 선택합니다.

웹 파일

다음은 웹 파일을 구성할 때 발생하는 문제입니다.

웹 파일이 활성이 아님

이 문제를 해결하려면 웹 파일이 활성 상태인지 확인하세요.

웹 파일의 부분 URL이 잘못 구성됨

이 문제를 해결하려면 부분 URL이 루트 페이지로 홈을 사용하는 파일 이름인지 확인하십시오.

웹 파일에 첨부 파일이 없음

이 문제를 해결하려면 웹 파일의 메모 섹션에 해당 CSS 파일을 추가합니다.

첨부 파일에 콘텐츠가 없음

이 문제를 해결하려면 웹 파일의 메모 섹션에 전체 콘텐츠가 있는 CSS 파일을 추가합니다.

파일 MIME 형식이 텍스트/CSS가 아님

이 문제를 해결하려면 CSS 파일의 MIME 형식을 다시 정의하는 플러그 인 또는 흐름이 없는지 확인하세요.

웹 페이지

다음 문제는 웹 사이트와 관련이 있습니다.

지역화된 콘텐츠 페이지를 상위 웹 페이지로 연결한 웹 페이지

이 문제는 웹 페이지 레코드에 언어 콘텐츠 페이지와 연관된 상위 웹 페이지가 있을 때 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 콘텐츠 페이지가 아닌 올바른 웹 페이지 레코드를 가리키도록 상위 페이지 필드를 업데이트합니다.

웹 페이지가 다른 웹 사이트에 속합니다.

이 문제는 상위 웹 페이지가 하위 웹 페이지와 다른 웹 사이트와 연결된 경우 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지(상위 웹 페이지 또는 하위 웹 페이지)를 선택합니다.
4. 웹 사이트 필드를 업데이트하여 적절한 웹 사이트를 가리킵니다.

웹 페이지에 게시 상태가 없습니다.

이 문제는 웹 페이지 레코드에 해당하는 게시 상태가 없을 때 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 게시 상태 레코드를 가리키도록 게시 상태 필드를 업데이트합니다.

웹 페이지에 다른 웹 사이트에 속한 페이지 템플릿이 있습니다.

이 문제는 페이지 템플릿이 다른 웹 사이트와 연결된 경우에 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 웹 사이트 필드를 업데이트하여 적절한 웹 사이트를 가리킵니다.
5. 또는 페이지 템플릿을 업데이트하여 동일한 웹 사이트의 템플릿을 가리키도록 합니다.

웹 페이지에 다른 웹 사이트에 속한 게시 상태가 있습니다.

이 문제는 게시 상태이 다른 웹 사이트와 연결된 경우에 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 게시 상태 필드를 업데이트하여 동일한 웹 사이트의 게시 상태 레코드를 가리킵니다.

웹 페이지가 비활성 페이지 템플릿을 사용하려고 합니다.

이 문제는 페이지 템플릿 레코드가 비활성 상태일 때 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 상위 템플릿 레코드를 선택하여 레코드로 이동합니다.
5. 명령 모음에서 활성화를 선택합니다.
6. 또는 페이지 템플릿을 업데이트하여 웹페이지의 활성 페이지 템플릿을 가리키도록 합니다.

웹 페이지에 활성 상태의 지역화된 언어 콘텐츠 페이지가 하나 이상 필요합니다.

이 문제는 웹 페이지에 하나 이상의 언어 콘텐츠 페이지가 없을 때 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.

2. 왼쪽 창에서 웹 페이지를 선택합니다.

3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.

4. 아래로 스크롤하여 현지화된 콘텐츠 섹션으로 이동합니다.

5. + 새 웹 페이지를 선택하여 새 언어 콘텐츠 페이지를 만듭니다.

   참고

   콘텐츠 페이지의 홈 페이지에 있는 구성 필드는 기존 콘텐츠 페이지에 상속되지 않습니다. 그것은 새 콘텐츠 페이지를 만들 때만 사용됩니다. 사용자가 콘텐츠 페이지 구성을 개별적으로 업데이트해야 합니다.

웹 페이지 게시가 숨겨져 있습니다.

이 문제는 게시 상태 IsVisible 필드를 선택하지 않은 경우에 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 게시 상태 레코드를 선택하여 레코드로 이동합니다.
5. IsVisible 필드를 선택하고 선택되어 있는지 확인합니다(true로 설정).

페이지 템플릿이 없는 웹 페이지

이 문제는 웹 페이지 레코드에 해당하는 페이지 템플릿이 없을 때 발생합니다. 이 문제를 해결하는 방법:

1. 포털 관리 앱을 엽니다.
2. 왼쪽 창에서 웹 페이지를 선택합니다.
3. 포털 검사기 진단 결과에서 나열된 웹 페이지를 선택합니다.
4. 활성 페이지 템플릿 레코드를 가리키도록 페이지 템플릿 필드를 업데이트합니다.

참조 항목

포털 검사기 실행