Auth-Sample

To make sure the security between the interfaces of services, users can enable RSA Authorizaiton by simple configuration as below.

Consumer Service

• Add dependence in pom.xml file:

  <dependency>
        <groupId>org.apache.servicecomb</groupId>
        <artifactId>handler-publickey-auth</artifactId>
   </dependency>
  

• Add handler chain in microservice.yaml:

  cse:
    # other configurations omitted
    handler:
      chain:
        Consumer:
          default: auth-consumer
  

Provider Service

• Add dependence in pom.xml file:

  <dependency>
        <groupId>org.apache.servicecomb</groupId>
        <artifactId>handler-publickey-auth</artifactId>
   </dependency>
  

• Add handler chain in microservice.yaml:

  cse:
    # other configurations omitted
    handler:
      chain:
        Consumer:
          default: auth-provider
  

Sample Quick Start

Auth sample use RestTemplate to present RSA communication between provider and consumer.

1. Start the ServiceComb/Service Center

   • how to start the service center
   • make sure service center address is configured correctly in microservice.yaml file

   cse:
     service:
       registry:
         address: http://127.0.0.1:30100		#service center address
   

2. Start the auth-provider service

   • Start provider service by maven

     Compile the source code at root directory of ServiceComb Java Chassis, which is servicecomb-java-chassis/, and use mvn exec to execute the main class AuthProviderMain.

     cd servicecomb-java-chassis/
     mvn clean install -Psamples -DskipTests			#only need to install at first time.
     cd samples/auth-sample/auth-provider/
     mvn exec:java -Dexec.mainClass="org.apache.servicecomb.samples.auth.provider.AuthProviderMain"
     

   • Start provider service by IDE

     Import the project by InteliJ IDEA or Eclipse, add sample module to pom.xml file in root module servicecomb-java-chassis/pom.xml, and add <module>samples</module> to <modules></modules> block, Then find main function AuthProviderMain of provider service and RUN it like any other Java program.

3. Start the auth-consumer service

   Just like how to start auth-provider service. But the main class of auth-consumer service is AuthConsumerMain.

   cd samples/auth-sample/auth-consumer/
   mvn exec:java -Dexec.mainClass="org.apache.servicecomb.samples.auth.consumer.AuthConsumerMain"
   

4. How to verify On the producer side, the output should contain the following stuffs if the producer starts up successfully:

   1. ‘swagger: 2.0 info: version: 1.0.0 ...’ means the producer generated swagger contracts
   2. ‘rest listen success. address=0.0.0.0:8080’ means the rest endpoint is listening on port 8080
   3. ‘highway listen success. address=0.0.0.0:7070’ means the highway endpoint is listening on port 7070
   4. ‘Register microservice instance success’ means the producer has registered successfully to service center

   On the consumer side, you can see the following outputs if the consumer can invoke the producer:

   1. ‘Hello Authenticate’ means the consumer calls sayhi with name=Authenticate successfully
   2. ‘Hello person ServiceComb/Authenticate’ means the consumer calls sayhello successfully