Khắc phục sự cố khi triển khai chính sách Xác thực thông báo SOAP

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X. thông tin

InvalidResourceType

Thông báo Lỗi

Việc triển khai proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge không thành công và xuất hiện thông báo lỗi sau:

Error Deploying Revision revision_number to environment
MessageValidation soap_message_validation_policy: Invalid Resource Type resource_type. It should be xsd or wsdl. Context Revision:revision_number;APIProxy:apiproxy_name;Organization:organization;Environment:environment.

Thông báo lỗi mẫu

Error Deploying Revision 1 to test
MessageValidation SOAP-Message-Validation-1: Invalid Resource Type py.
It should be xsd or wsdl. Context Revision:1;APIProxy:soapmessagevalidation;
Organization:gsc-hipaa;Environment:test.

Ảnh chụp màn hình ví dụ về lỗi

Nguyên nhân

Lỗi này xảy ra nếu phần tử <ResourceURL> trong chính sách SOAPMessageValidation được đặt thành một loại tài nguyên mà chính sách không hỗ trợ. Các loại tài nguyên được hỗ trợ là xsd và wsdl.

Chẩn đoán

1. Xác định tên chính sách SOAPMessageValidation và loại tài nguyên không hợp lệ được dùng trong phần tử <ResourceURL> của chính sách. Bạn có thể tìm thấy cả hai mục này trong thông báo lỗi. Ví dụ: trong lỗi sau đây, tên chính sách SOAPMessageValidation là SOAP-Message-Validation-1 và loại tài nguyên là py.

   Error Deploying Revision 1 to test
   MessageValidation SOAP-Message-Validation-1: Invalid Resource Type py. It should
   be xsd or wsdl. Context Revision:1;APIProxy:soapmessagevalidation;Organization:gsc-
   hipaa;Environment:test.
   

2. Kiểm tra tệp XML chính sách SOAPMessageValidation không thành công. Nếu loại tài nguyên được chỉ định cho phần tử <ResourceURL> khớp với loại tài nguyên không hợp lệ được xác định ở Bước 1 ở trên, thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây chỉ định loại tài nguyên là py, khớp với nội dung trong thông báo lỗi:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <MessageValidation async="false" continueOnError="false" enabled="true"
       name="SOAP-Message-Validation-1">
       <DisplayName>SOAP Message Validation-1</DisplayName>
       <Properties/>
       <Element namespace="http://sample.com"> sampleObject</Element>
       <SOAPMessage/>
       <Source>request</Source>
       <ResourceURL>py://Script-1.py</ResourceURL>
   </MessageValidation>
   

   Vì loại tài nguyên được dùng trong <ResourceURL> không phải là xsd hoặc wsdl, nên quá trình triển khai sẽ không thành công với lỗi như trên.

Độ phân giải

Đảm bảo rằng loại tài nguyên được chỉ định trong phần tử <ResourceURL> của chính sách SOAPMessageValidation được đặt thành xsd hoặc wsdl, đồng thời tệp tài nguyên sử dụng đúng định dạng.

Để sửa chính sách SOAPMessageValidation trong ví dụ nêu trên, bạn có thể sửa đổi loại tài nguyên thành xsd hoặc wsdl:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true"
name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://sample.com"> sampleObject</Element>
    <SOAPMessage/>
    <Source>request</Source>
<ResourceURL>wsdl://SOAP-Message-Validation-1.wsdl</ResourceURL>
</MessageValidation>

ResourceCompileFailed

Thông báo Lỗi

Việc triển khai proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge không thành công và xuất hiện thông báo lỗi sau:

Error Deploying Revision revision_number to environment
MessageValidation soap_message_validation_policy: Failed to compile resource resource. Context Revision:revision_number;APIProxy:apiproxy_name;Organization:organization;Environment:environment.

Thông báo lỗi mẫu

Error Deploying Revision 1 to test
MessageValidation SOAP-Message-Validation-1: Failed to compile resource SOAP-Message-Validation-1.wsdl. Context Revision:1;APIProxy:soapmessagevalidation;Organization:gsc-hipaa;Environment:test.

Ảnh chụp màn hình ví dụ về lỗi

Nguyên nhân

Lỗi này xảy ra nếu tập lệnh tài nguyên được tham chiếu trong phần tử <ResourceURL> của chính sách SOAPMessageValidation có chứa một lỗi khiến tập lệnh không thể biên dịch trong quá trình triển khai.

Chẩn đoán

1. Xác định tên chính sách SOAPMessageValidation và tập lệnh tài nguyên được dùng trong chính sách. Bạn có thể tìm thấy cả hai mục này trong thông báo lỗi. Ví dụ: trong lỗi sau, tên chính sách SOAPMessageValidation là SOAP-Message-Validation-1 và tập lệnh tài nguyên là SOAP-Message-Validation-1.wsdl.

   Error Deploying Revision 1 to test
   MessageValidation SOAP-Message-Validation-1: Failed to compile resource
   SOAP-Message-Validation-1.wsdl. Context
   Revision:1;APIProxy:soapmessagevalidation;Organization:gsc-hipaa;
   Environment:test.
   

2. Kiểm tra tệp XML chính sách SOAPMessageValidation không thành công và xác minh rằng tập lệnh tài nguyên được chỉ định cho phần tử <ResourceURL> khớp với nội dung trong thông báo lỗi.

   Ví dụ: chính sách sau đây chỉ định phần tử <ResourceURL> là SOAP-Message-Validation-1.wsdl, khớp với nội dung trong thông báo lỗi:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <MessageValidation async="false" continueOnError="false" enabled="true"
   name="SOAP-Message-Validation-1">
       <DisplayName>SOAP Message Validation-1</DisplayName>
       <Properties/>
       <Element namespace="http://sample.com"> sampleObject</Element>
       <SOAPMessage/>
       <Source>request</Source>
       <ResourceURL>wsdl://SOAP-Message-Validation-1.wsdl</ResourceURL>
   </MessageValidation>
   

3. Xem tệp kịch bản tài nguyên được xác định trong Bước 1 và xem có vấn đề tiềm ẩn nào có thể dẫn đến lỗi biên dịch hay không.

   Dưới đây là một ví dụ về tệp kịch bản tài nguyên:

   <?xml version="1.0" encoding="ISO-8859-1"?>
   <wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsd/">
       <wsdl:types>
           <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
               <xs:element name="request" type="xs:string"/>
           </xs:schema>
       </wsdl:types>
   </wsdl:definitions>
   

   Vì xmlns:wsdl trỏ đến một URL không hợp lệ, nên quá trình triển khai sẽ không thành công với lỗi như trên.

Độ phân giải

Đảm bảo rằng tập lệnh tài nguyên được chỉ định trong phần tử <ResourceURL> của chính sách SOAPMessageValidation không gặp phải vấn đề nào khiến tập lệnh này không thể biên dịch.

Để sửa tập lệnh SOAP-Message-Validation-1.wsdl xuất hiện ở trên, bạn có thể sửa đổi xmlns:wsdl để trỏ đến một URL hợp lệ:

<?xml version="1.0" encoding="ISO-8859-1"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:types>
        <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
            <xs:element name="request" type="xs:string"/>
        </xs:schema>
    </wsdl:types>
</wsdl:definitions>

RootElementNameUnspecified

Thông báo Lỗi

Việc lưu proxy API thông qua giao diện người dùng Edge hoặc Edge Management API không thành công và bạn sẽ nhận được thông báo lỗi sau:

Error Saving Revision revision_number
MessageValidation soap_message_validation_policy:
RootElement name is not specified.

Thông báo lỗi mẫu

Error Saving Revision 2
MessageValidation SOAP-Message-Validation-1: RootElement name is not specified.

Ảnh chụp màn hình ví dụ về lỗi

Nguyên nhân

Lỗi này xảy ra nếu phần tử <Element> trong chính sách SOAPMessageValidation không chứa tên của phần tử gốc.

Chẩn đoán

1. Xác định tên chính sách SOAPMessageValidation nơi xảy ra lỗi. Ví dụ: trong lỗi sau, tên chính sách SOAPMessageValidation là SOAP-Message-Validation-1:

   Error Saving Revision 2
   MessageValidation SOAP-Message-Validation-1: RootElement name is not specified.
   

2. Kiểm tra tệp XML chính sách SOAPMessageValidation không thành công. Nếu tên phần tử gốc dùng để xác thực không được chỉ định trong phần tử <Element>, thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây không chỉ định tên phần tử gốc:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <MessageValidation async="false" continueOnError="false" enabled="true"
   name="SOAP-Message-Validation-1">
       <DisplayName>SOAP Message Validation-1</DisplayName>
       <Properties/>
       <Element namespace="http://schemas.xmlsoap.org/soap/prices"/>
       <SOAPMessage/>
       <Source>request</Source>
       <ResourceURL>xsd://Script-1.xsd</ResourceURL>
   </MessageValidation>
   

   Vì bạn không chỉ định tên phần tử gốc, nên quá trình triển khai sẽ không thành công với lỗi như minh hoạ ở trên.

Độ phân giải

Đảm bảo rằng phần tử <Element> của chính sách SOAPMessageValidation chứa phần tử gốc chính xác.

Để sửa chính sách SOAPMessageValidation như minh hoạ ở trên, bạn có thể sửa đổi <Element> và thêm một phần tử gốc hợp lệ như sau:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true"
name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://schemas.xmlsoap.org/soap/prices">GetPriceResponse</Element>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

InvalidRootElementName

Thông báo Lỗi

Việc lưu proxy API thông qua giao diện người dùng Edge hoặc Edge Management API không thành công và bạn sẽ nhận được thông báo lỗi sau:

Error Saving Revision revision_number
MessageValidation soap_message_validation_policy: RootElement name root_element_name is invalid.

Thông báo lỗi mẫu

Error Saving Revision 2
MessageValidation SOAP-Message-Validation-1: RootElement name 1GetPriceResponse
is invalid.

Ảnh chụp màn hình ví dụ về lỗi

Nguyên nhân

Lỗi này xảy ra nếu phần tử <Element> trong chính sách SOAPMessageValidation chứa một tên phần tử gốc không tuân thủ các quy tắc XML để đặt tên phần tử hợp lệ.

Chẩn đoán

1. Xác định tên chính sách SOAPMessageValidation nơi xảy ra lỗi. Ví dụ: trong lỗi sau, tên chính sách SOAPMessageValidation là SOAP-Message-Validation-1:

   Error Saving Revision 2
   MessageValidation SOAP-Message-Validation-1: RootElement name 1GetPriceResponse
   is invalid.
   

2. Kiểm tra tệp XML chính sách SOAPMessageValidation không thành công. Nếu tên phần tử gốc được chỉ định trong phần tử <Element> không đáp ứng các tiêu chí về tên phần tử XML hợp lệ, thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: chính sách sau đây có tên phần tử gốc bắt đầu bằng một số, điều này là không hợp lệ. Tên phần tử chứa khoảng trắng cũng sẽ không hợp lệ.

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <MessageValidation async="false" continueOnError="false" enabled="true"
   name="SOAP-Message-Validation-1">
       <DisplayName>SOAP Message Validation-1</DisplayName>
       <Properties/>
        <Element namespace="http://schemas.xmlsoap.org/soap/prices">1GetPriceResponse</Element>
       <SOAPMessage/>
       <Source>request</Source>
       <ResourceURL>xsd://Script-1.xsd</ResourceURL>
   </MessageValidation>
   

Độ phân giải

Đảm bảo rằng phần tử <Element> của chính sách SOAPMessageValidation chứa tên phần tử gốc hợp lệ.

Để sửa chính sách SOAPMessageValidation như minh hoạ ở trên, bạn có thể sửa đổi phần tử <Element> để chứa một tên phần tử gốc hợp lệ, như minh hoạ dưới đây:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<MessageValidation async="false" continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
    <DisplayName>SOAP Message Validation-1</DisplayName>
    <Properties/>
    <Element namespace="http://schemas.xmlsoap.org/soap/prices">GetPriceResponse</Element>
    <SOAPMessage/>
    <Source>request</Source>
    <ResourceURL>xsd://Script-1.xsd</ResourceURL>
</MessageValidation>

NoElements

Thông báo Lỗi

Việc triển khai proxy API thông qua giao diện người dùng Edge hoặc API quản lý Edge không thành công với thông báo lỗi sau:

Error Deploying Revision revision_number
Resource "resource_url" has no element definitions.

Thông báo lỗi mẫu

Error Deploying Revision 2 to test
Resource "xsd://Script-1.xsd" has no element definitions.

Ảnh chụp màn hình ví dụ về lỗi

Nguyên nhân

Lỗi này xảy ra nếu tệp tài nguyên được chỉ định trong phần tử <Resource> của chính sách SOAPMessageValidation không chứa bất kỳ phần tử nào có thể dùng để xác thực.

Chẩn đoán

1. Xác định các định nghĩa phần tử bị thiếu trong tệp tài nguyên từ thông báo lỗi. Ví dụ: trong lỗi sau, tệp tài nguyên được dùng trong là xsd://Script-1.xsd:

   Error Deploying Revision 2 to test
   Resource "xsd://Script-1.xsd" has no element definitions.
   

2. Kiểm tra tệp tài nguyên được xác định trong Bước 1. Nếu không có phần tử nào được xác định, thì đó là nguyên nhân gây ra lỗi.

   Ví dụ: tệp tài nguyên Script-1.xsd sau đây không chứa bất kỳ phần tử nào:

   <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   </xsd:schema>
   

   Vì tệp tài nguyên không có phần tử nào nên quá trình triển khai sẽ không thành công với lỗi như trên.

Độ phân giải

Đảm bảo rằng tệp tài nguyên được dùng trong chính sách SOAPMessageValidation chứa các định nghĩa phần tử có liên quan.

Để sửa tệp tài nguyên ví dụ nêu trên, bạn có thể sửa đổi tệp xsd để thêm nội dung sau:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="shipOrder" type="order"/>
<xsd:complexType name="order">
<xsd:sequence>
<xsd:element name="shipTo" type="shipAddress"/>
<xsd:element name="items" type="cdItems"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="shipAddress">
<xsd:sequence>
<xsd:element name="name" type="xsd:string"/>
<xsd:element name="street" type="xsd:string"/>
<xsd:element name="address" type="xsd:string"/>
<xsd:element name="country" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="cdItems">
<xsd:sequence>
<xsd:element name="item" type="cdItem" maxOccurs="unbounded"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="cdItem">
<xsd:sequence>
<xsd:element name="title" type="xsd:string"/>
<xsd:element name="quantity" type="xsd:integer"/>
<xsd:element name="price" type="xsd:decimal"/>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>