डब्लूएसएफ / पीएचपी के आधार पर एक वेब सेवा का निर्माण यूजरनेम प्राधिकरण और एचटीटीपीएस के साथ

मुझे सिद्धांत रूप में वेब सेवाओं से निपटने और PHP में एक सेवा (एक सेवा क्लाइंट नहीं) लिखने की संभावनाओं के बारे में जानने का निर्देश दिया गया था, जिसे WS और WS- सुरक्षा मानकों के अनुसार एक्सेस किया जा सकता है। इसके अलावा, .NET क्लाइंट के साथ संगतता की आवश्यकता थी (मेरे मामले में, WCF के बिना काम पर्याप्त था)।

थोड़े से Google के बाद, यह स्पष्ट हो गया कि न तो मानक PHP SOAP पुस्तकालय, न ही Zend फ्रेमवर्क, और न ही WSF / PHP के अलावा कुछ भी नहीं है एक फ़ाइल के बिना WS- सुरक्षा का समर्थन करते हैं, और जल्दबाजी में मिली फाइलें केवल एक निश्चित समाधान की पेशकश करती हैं, उदाहरण के लिए, UserToken एक सादे पासवर्ड के साथ (आदर्श रूप से, हस्ताक्षर, एन्क्रिप्शन, प्रमाण पत्र, और इसी तरह और आगे) की आवश्यकता है।

यह समाधान WSFL पीढ़ी जैसे WSF / PHP फ्रेमवर्क की सभी विशेषताओं का वर्णन नहीं करता है, क्योंकि यह सब प्रलेखन में वर्णित है और किसी भी गैर-तुच्छ प्रलेखन समाधान की आवश्यकता नहीं है। हम लाइब्रेरी के संस्करण 2.1.0 के साथ काम करेंगे।

ट्रेनिंग

इसके साथ शुरू करने के लिए, सुनिश्चित करें कि सभी आवश्यक घटक स्थापित हैं। मेरी सेवा उबंटू 11.04 पर चालू हुई, क्लाइंट एप्लिकेशन C # (नीचे दी गई सूचियों में मैं इसका कोड और कॉन्फ़िगरेशन दूंगा) लिखा गया था। WSF / PHP और आपके द्वारा आवश्यक सेवा के साथ काम करने के लिए:

• Apache2 + mod_ssl,
• PHP5 + xsl (मैंने PHP5.3 पर काम किया),
• GNOME XML लाइब्रेरी,
• दरअसल, WSO2 WSF / PHP 2.1.0 ।

सभी घटकों की स्थापना और कॉन्फ़िगरेशन इंटरनेट पर कई संसाधनों में वर्णित है, स्थापना और कॉन्फ़िगरेशन प्रलेखन में वर्णित हैं (परिचय में लिंक देखें)। कृपया ध्यान दें कि PHP मॉड्यूल को कॉन्फ़िगर करते समय, wsf.home विकल्प उस पथ को इंगित करता है जहां लाइब्रेरी स्थापित है (मेरे मामले में यह /opt/wso2/wsf_c )।

सेवा

हमारी सेवा एकमात्र ऑपरेशन है जो इसके लिए दिए गए तर्क को चुकता करता है और इसे वापस करता है। संक्षेप में, कोड की सामग्री: findSquare फ़ंक्शन, जो वास्तव में, हमारा कार्य करता है; फ़ंक्शन नाम को ऑपरेशन नाम बांधना, सुरक्षा नीति घोषित करना और एक टोकन बनाना (इस उदाहरण में, उपयोगकर्ता नाम और पासवर्ड हार्डकोड किया गया है, लेकिन WSSecurityToken कंस्ट्रक्टर ( API देखें) में पासवर्डकॉलबैक तर्क का उपयोग करते हुए, आप एक फ़ंक्शन निर्दिष्ट कर सकते हैं जो उदाहरण के लिए, इसे लॉगिन से खींच सकते हैं डेटाबेस पासवर्ड, और आगे सत्यापन के लिए इसे वापस करें); सभी मापदंडों और प्रसंस्करण कॉल के साथ WSService का एक उदाहरण बनाना।

मान लें कि सेवा को index.php फ़ाइल में संग्रहीत किया गया है

 <?php function findSquare($integer) { $result = pow($integer, 2); return array("result"=>$result); } $operations = array( "squareInt" => "findSquare" ); // operations mapping $securityPolicy = new WSPolicy(file_get_contents('spolicy.xml')); // security policy $securityToken = new WSSecurityToken(array( "user"=>"god", "password"=>"iddqd", "passwordType"=>"PlainText", "ttl" => 100)); // security token $service = new WSService(array( "wsdl"=>"index.wsdl", "operations" => $operations, "serviceName" => "TestService", "policy"=>$securityPolicy, "securityToken"=>$securityToken )); // service instance $service->reply(); ?> 

हमारे पास दो निर्भरताएं हैं: spolicy.xml और index.wsdl । WSDL को मानक WSF / PHP टूल द्वारा उत्पन्न किया गया था - सेवा URL में ?wsdl पैरामीटर को जोड़ने पर (सही प्रकारों के साथ WSDL को उत्पन्न करने के लिए कैसे, आदि पर, फिर से, प्रलेखन पढ़ें: इस बिंदु को काफी समझदारी से वर्णित किया गया है)।

अब spolicy.xml माध्यम से जाना। यह एक XML फ़ाइल है जिसे WS-SecurityPolicy विनिर्देशन के अनुसार लिखा गया है। WSPolicy कंस्ट्रक्टर के तर्कों में सब कुछ वर्णन करना संभव था, लेकिन कुछ समय बाद UsernameToken को क्लाइंट से एक हस्ताक्षर की आवश्यकता होती है, जिसकी हमें इस कार्य में आवश्यकता नहीं है, और कंस्ट्रक्टर तर्क WS-SecurityPolicy की केवल मूल क्षमता प्रदान करते हैं। इसके अलावा, हमें यह घोषणा करने की आवश्यकता है कि सुरक्षा मुद्दे परिवहन, या HTTPS पर हैं।

 <wsp:Policy xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"> <wsp:ExactlyOne> <wsp:All> <sp:TransportBinding> <wsp:Policy> <sp:IncludeTimestamp/> </wsp:Policy> </sp:TransportBinding> <sp:SignedSupportingTokens> <wsp:Policy> <sp:UsernameToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"> <wsp:Policy> <sp:WssUsernameToken10 /> </wsp:Policy> </sp:UsernameToken> <sp:IncludeTimestamp/> </wsp:Policy> </sp:SignedSupportingTokens> </wsp:All> </wsp:ExactlyOne> </wsp:Policy> 

मैं भी index.wsdl करेगा ( domain.tld को डोमेन या सेवा द्वारा उपयोग किए गए आईपी के साथ बदल दिया जाना चाहिए):

 <?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://www.wso2.org/php" xmlns:tnx="http://www.wso2.org/php/xsd" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:http="http://www.w3.org/2003/05/soap/bindings/HTTP/" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl" targetNamespace="http://www.wso2.org/php"> <types> <xsd:schema elementFormDefault="qualified" targetNamespace="http://www.wso2.org/php/xsd"> <xsd:element name="squareInt"> <xsd:complexType> <xsd:sequence> <xsd:element name="integer" type="xsd:int"/> </xsd:sequence> </xsd:complexType> </xsd:element> <xsd:element name="squareIntResponse"> <xsd:complexType> <xsd:sequence> <xsd:element name="result" type="xsd:int"/> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema> </types> <message name="squareInt"> <part name="parameters" element="tnx:squareInt"/> </message> <message name="squareIntResponse"> <part name="parameters" element="tnx:squareIntResponse"/> </message> <portType name="TestServicePortType"> <operation name="squareInt"> <input message="tns:squareInt"/> <output message="tns:squareIntResponse"/> </operation> </portType> <binding name="TestServiceSOAPBinding" type="tns:TestServicePortType"> <soap:binding xmlns="http://schemas.xmlsoap.org/wsdl/soap/" transport="http://schemas.xmlsoap.org/soap/http" style="document"/> <operation xmlns:default="http://schemas.xmlsoap.org/wsdl/soap/" name="squareInt"> <soap:operation xmlns="http://schemas.xmlsoap.org/wsdl/soap/" soapAction="https://domain.tld:443/index.php/squareInt" style="document"/> <input xmlns:default="http://schemas.xmlsoap.org/wsdl/soap/"> <soap:body xmlns="http://schemas.xmlsoap.org/wsdl/soap/" use="literal"/> </input> <output xmlns:default="http://schemas.xmlsoap.org/wsdl/soap/"> <soap:body xmlns="http://schemas.xmlsoap.org/wsdl/soap/" use="literal"/> </output> </operation> </binding> <service name="TestService"> <port xmlns:default="http://schemas.xmlsoap.org/wsdl/soap/" name="TestServiceSOAPPort_Http" binding="tns:TestServiceSOAPBinding"> <soap:address xmlns="http://schemas.xmlsoap.org/wsdl/soap/" location="https://domain.tld:443/index.php"/> </port> </service> </definitions> 

यह सेवा का विवरण पूरा करता है। यदि सब कुछ सही ढंग से किया जाता है, तो यदि आप ब्राउज़र में सेवा का पता खोलते हैं, तो तैनात सेवाओं का विवरण और उनके संचालन की एक सूची खुल जाएगी।

ग्राहक

क्लाइंट एक C # कंसोल एप्लिकेशन है जो कॉन्फ़िगरेशन में निर्दिष्ट पते पर दस्तक देता है और परिणाम प्राप्त करता है। लॉगिन, पासवर्ड और प्रेषित मूल्य हार्डकोड किया गया है, लेकिन कोई भी आपको इस चूक को सुधारने के लिए परेशान नहीं करता है।

 internal class Program { // Methods private static void Main() { try { ServicePointManager.ServerCertificateValidationCallback = delegate (object sender, X509Certificate cert, X509Chain chain, SslPolicyErrors errors) { return true; }; TestServicePortTypeClient client = new TestServicePortTypeClient(); client.ClientCredentials.UserName.UserName = "god"; client.ClientCredentials.UserName.Password = "iddqd"; Console.WriteLine(client.squareInt(5)); } catch (Exception exception) { Console.WriteLine(exception); } finally { Console.ReadKey(); } } } 

कॉन्फ़िगरेशन फ़ाइल ( domain.tld को डोमेन या सेवा द्वारा उपयोग किए गए आईपी के साथ बदल दिया जाना चाहिए):

 <?xml version="1.0" encoding="utf-8" ?> <configuration> <system.serviceModel> <bindings> <basicHttpBinding> <binding name="TestServiceSOAPBinding"> <security mode="TransportWithMessageCredential"> <transport clientCredentialType="None" proxyCredentialType="None" realm="" /> <message clientCredentialType="UserName" algorithmSuite="Default" /> </security> </binding> </basicHttpBinding> </bindings> <client> <endpoint address="https://domain.tld/index.php" binding="basicHttpBinding" bindingConfiguration="TestServiceSOAPBinding" contract="MyServiceReference.TestServicePortType" name="TestServiceSOAPPort_Http" /> </client> </system.serviceModel> </configuration> 

परिणाम

नतीजतन, 25 को कंसोल विंडो में प्रदर्शित किया जाना चाहिए, या, यदि आपने क्लाइंट कोड को सही किया है, तो अपने हाथों से, अपने नंबर के वर्ग के साथ प्रारंभिक मूल्य दर्ज करें।