juliusl-azure-sdk-for-ruby 0.7.0

data/lib/azure/cloud_service_management/serialization.rb

@@ -0,0 +1,118 @@
+#-------------------------------------------------------------------------
+# Copyright 2013 Microsoft Open Technologies, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require 'base64'
+require 'azure/cloud_service_management/cloud_service'
+require 'azure/virtual_machine_management/serialization'
+
+module Azure
+  module CloudServiceManagement
+    module Serialization
+      extend Azure::Core::Utility
+      def self.cloud_services_to_xml(name, options = {})
+        options[:label] = options[:label] || name
+
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.CreateHostedService(
+            'xmlns' => 'http://schemas.microsoft.com/windowsazure'
+          ) do
+            xml.ServiceName(name)
+            xml.Label(Base64.encode64(options[:label]))
+            xml.Description(options[:description]) unless\
+              options[:description].nil? || options[:description].empty?
+
+            unless options[:affinity_group_name].nil?
+              xml.AffinityGroup(options[:affinity_group_name])
+            else
+              xml.Location(options[:location])
+            end
+
+            xml.ExtendedProperties do
+              options[:extended_properties].each do |prop_name, prop_value|
+                xml.ExtendedProperty do
+                  xml.Name(prop_name)
+                  xml.Value(prop_value)
+                end unless (prop_name.nil? || prop_name.empty?)\
+                  || (prop_value.nil? || prop_value.empty?)
+              end
+            end unless options[:extended_properties].nil?\
+              || options[:extended_properties].empty?
+          end
+        end
+        builder.doc.to_xml
+      end
+
+      def self.cloud_services_from_xml(cloud_xml)
+        clouds = []
+        cloud_services_xml = cloud_xml.css('HostedServices HostedService')
+        cloud_services_xml = cloud_xml.css('HostedService') if \
+          cloud_services_xml.length == 0
+        cloud_services_xml.each do |cloud_service_xml|
+          cloud = CloudService.new
+          cloud.url = xml_content(cloud_service_xml, 'Url')
+          cloud.name = xml_content(cloud_service_xml, 'ServiceName')
+
+          props_xml = cloud_service_xml.css('HostedServiceProperties')
+
+          cloud.label = Base64.decode64(xml_content(props_xml, 'Label'))
+          cloud.description = xml_content(props_xml, 'Description')
+          location = xml_content(props_xml, 'Location')
+          cloud.location = location unless location.empty?
+          affinity_group =  xml_content(props_xml, 'AffinityGroup')
+          cloud.affinity_group = affinity_group unless affinity_group
+          cloud.status = xml_content(props_xml, 'Status')
+          cloud.date_created = xml_content(props_xml, 'DateCreated')
+          cloud.date_modified = xml_content(props_xml, 'DateLastModified')
+
+          cloud.extended_properties = {}
+          props_xml.css('ExtendedProperties ExtendedProperty').map do |prop|
+            p_name = xml_content(prop, 'Name')
+            p_value = xml_content(prop, 'Value')
+            cloud.extended_properties[p_name] = p_value
+          end
+
+          cloud.default_winrm_certificate_thumbprint = xml_content(
+            cloud_service_xml, 'DefaultWinRMCertificateThumbprint'
+          )
+          deployment_xml = cloud_services_xml.css('Deployments Deployment')
+          cloud.deployment_name = xml_content(deployment_xml, 'Name')
+          vms_in_deployment = {}
+
+          cloud_service_xml.css('Deployments').each do |deployxml|
+            deployment_name = xml_content(deployxml, 'Deployment Name')
+            vms = Azure::VirtualMachineManagement::Serialization.virtual_machines_from_xml(
+              deployxml, cloud.name
+            )
+            vms_in_deployment[deployment_name.to_sym] = vms if vms
+          end
+
+          cloud.virtual_machines = vms_in_deployment
+          clouds << cloud
+        end
+        clouds.compact
+      end
+
+      def self.add_certificate_to_xml(data)
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.CertificateFile('xmlns' => 'http://schemas.microsoft.com/windowsazure') do
+            xml.Data data
+            xml.CertificateFormat 'pfx'
+            xml.Password nil
+          end
+        end
+        builder.doc.to_xml
+      end
+    end
+  end
+end

data/lib/azure/core.rb

@@ -0,0 +1,41 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+
+module Azure::Core; end
+
+require 'azure/core/error'
+require 'azure/core/configuration'
+
+# load default configuration from environment variables
+# (user can always override this later)
+Azure.configure do |config|
+  config.storage_access_key     = ENV['AZURE_STORAGE_ACCESS_KEY']
+  config.storage_account_name   = ENV['AZURE_STORAGE_ACCOUNT']
+  config.storage_table_host     = ENV['AZURE_STORAGE_TABLE_HOST']
+  config.storage_blob_host      = ENV['AZURE_STORAGE_BLOB_HOST']
+  config.storage_queue_host     = ENV['AZURE_STORAGE_QUEUE_HOST']
+
+  config.sb_namespace  = ENV['AZURE_SERVICEBUS_NAMESPACE']
+  config.sb_access_key  = ENV['AZURE_SERVICEBUS_ACCESS_KEY']
+  config.sb_issuer      = ENV['AZURE_SERVICEBUS_ISSUER']
+
+  config.management_certificate  = ENV['AZURE_MANAGEMENT_CERTIFICATE']
+  config.subscription_id         = ENV['AZURE_SUBSCRIPTION_ID']
+  config.management_endpoint     = ENV['AZURE_MANAGEMENT_ENDPOINT']
+  config.sql_database_management_endpoint = ENV['AZURE_SQL_DATABASE_MANAGEMENT_ENDPOINT']
+  config.sql_database_authentication_mode = ENV['AZURE_SQL_DATABASE_AUTHENTICATION_MODE']
+
+  config.ca_file = ENV['SSL_CERT_FILE']
+end

data/lib/azure/core/auth/authorizer.rb

@@ -0,0 +1,36 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "azure/core/configuration"
+
+module Azure
+  module Core
+    module Auth
+      class Authorizer
+        # Public: Signs an HTTP request before it's made, by adding the
+        # Authorization header
+        #
+        # request - An Azure::Core::HttpRequest that hasn't been signed
+        # signer  - A signing strategy, such as Azure::Table::Auth::SharedKey
+        #
+        # Returns the modified request
+        def sign(request, signer)
+          signature = signer.sign(request.method, request.uri, request.headers)
+          request.headers["Authorization"] = "#{signer.name} #{signature}"
+          request
+        end
+      end
+    end
+  end
+end

data/lib/azure/core/auth/shared_key.rb

@@ -0,0 +1,110 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "cgi"
+require "azure/core/configuration"
+require "azure/core/auth/signer"
+
+module Azure
+  module Core
+    module Auth
+      class SharedKey < Signer
+        # The Azure account's name.
+        attr :account_name
+
+        # Public: Initialize the Signer.
+        #
+        # account_name - The account name. Defaults to the one in the
+        #                global configuration.
+        # access_key   - The access_key encoded in Base64. Defaults to the
+        #                one in the global configuration.
+        def initialize(account_name=Azure.config.storage_account_name, access_key=Azure.config.storage_access_key)
+          @account_name = account_name
+          super(access_key)
+        end
+
+        # Public: The name of the strategy.
+        #
+        # Returns a String.
+        def name
+          "SharedKey"
+        end
+
+        # Public: Generate a request signature.
+        #
+        # verb       - The HTTP request method.
+        # uri        - The URI of the request we're signing.
+        # headers    - A Hash of HTTP request headers.
+        #
+        # Returns a Base64 String signed with HMAC.
+        def sign(method, uri, headers)
+          signature = super(signable_string(method, uri, headers))
+          return "#{account_name}:#{signature}"
+        end
+
+        # Generate the string to sign.
+        #
+        # verb       - The HTTP request method.
+        # uri        - The URI of the request we're signing.
+        # headers    - A Hash of HTTP request headers.
+        #
+        # Returns a plain text string.
+        def signable_string(method, uri, headers)
+          [
+            method.to_s.upcase,
+            headers.fetch("Content-Encoding", ""),
+            headers.fetch("Content-Language", ""),
+            headers.fetch("Content-Length", ""),
+            headers.fetch("Content-MD5", ""),
+            headers.fetch("Content-Type", ""),
+            headers.fetch("Date", ""),
+            headers.fetch("If-Modified-Since", ""),
+            headers.fetch("If-Match", ""),
+            headers.fetch("If-None-Match", ""),
+            headers.fetch("If-Unmodified-Since", ""),
+            headers.fetch("Range", ""),
+            canonicalized_headers(headers),
+            canonicalized_resource(uri)
+          ].join("\n")
+        end
+
+        # Calculate the Canonicalized Headers string for a request.
+        #
+        # headers - A Hash of HTTP request headers.
+        #
+        # Returns a string with the canonicalized headers.
+        def canonicalized_headers(headers)
+          headers = headers.map { |k,v| [k.to_s.downcase, v] }
+          headers.select! { |k,v| k =~ /^x-ms-/ }
+          headers.sort_by! { |(k,v)| k }
+          headers.map! { |k,v| "%s:%s" % [k, v] }
+          headers.map! { |h| h.gsub(/\s+/, " ") }.join("\n")
+        end
+
+        # Calculate the Canonicalized Resource string for a request.
+        #
+        # uri - The request's URI.
+        #
+        # Returns a string with the canonicalized resource.
+        def canonicalized_resource(uri)
+          resource = "/" + account_name + (uri.path.empty? ? "/" : uri.path)
+          params = CGI.parse(uri.query.to_s).map { |k,v| [k.downcase, v] }
+          params.sort_by! { |k,v| k }
+          params.map! { |k,v| "%s:%s" % [k, v.map(&:strip).sort.join(",")] }
+          [resource, *params].join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/azure/core/auth/shared_key_lite.rb

@@ -0,0 +1,48 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "azure/core/auth/shared_key"
+
+module Azure
+  module Core
+    module Auth
+      class SharedKeyLite < SharedKey
+        # Public: The name of the strategy.
+        #
+        # Returns a String.
+        def name
+          "SharedKeyLite"
+        end
+
+        # Generate the string to sign.
+        #
+        # verb       - The HTTP request method.
+        # uri        - The URI of the request we're signing.
+        # headers    - A Hash of HTTP request headers.
+        #
+        # Returns a plain text string.
+        def signable_string(method, uri, headers)
+          [
+            method.to_s.upcase,
+            headers.fetch("Content-MD5", ""),
+            headers.fetch("Content-Type", ""),
+            headers.fetch("Date") { raise IndexError, "Headers must include Date" },
+            canonicalized_headers(headers),
+            canonicalized_resource(uri)
+          ].join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/azure/core/auth/signer.rb

@@ -0,0 +1,52 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "openssl"
+require "base64"
+require "azure/core/configuration"
+
+module Azure
+  module Core
+    module Auth
+      # Public: Utility class to sign strings with HMAC-256 and then encode the
+      # signed string using Base64.
+      class Signer
+        # The access key for the account
+        attr :access_key
+
+        # Public: Initialize the Signer.
+        #
+        # access_key - The access_key encoded in Base64. Defaults to the one
+        #              in the global configuration.
+        def initialize(access_key=Azure.config.storage_access_key)
+          if access_key.nil?
+            raise ArgumentError, "storage access key must be provided"
+          end
+
+          @access_key = Base64.strict_decode64(access_key)
+        end
+
+        # Public: Generate an HMAC signature.
+        #
+        # body - The string to sign.
+        #
+        # Returns a Base64 String signed with HMAC.
+        def sign(body)
+          signed = OpenSSL::HMAC.digest("sha256", access_key, body)
+          Base64.strict_encode64(signed)
+        end
+      end
+    end
+  end
+end

data/lib/azure/core/configuration.rb

@@ -0,0 +1,218 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "singleton"
+
+module Azure
+
+  # Proxy config method.
+  def self.config
+    Core.config
+  end
+
+  # Proxy configure method.
+  def self.configure
+    yield Core.config
+  end
+
+  module Core
+
+    # Public: Sugar to configure the services in a neatly wrapped DSL.
+    #
+    # Yields the Azure::Configuration instance.
+    #
+    # Example:
+    #
+    #   Azure.configure do |config|
+    #     config.storage_account_name = ENV["AZURE_STORAGE_ACCOUNT"]
+    #   end
+    #
+    # Returns nothing.
+    def self.configure
+      yield config
+    end
+
+    # Public: Access the service configuration.
+    #
+    # Returns the Azure::Configuration instance.
+    def self.config
+      Configuration.instance
+    end
+
+    # Singleton that keeps the configuration of the system.
+    class Configuration
+      include Singleton
+
+      # Public: Get/Set the Access Key for this service.
+      attr_accessor :storage_access_key
+
+      # Public: Get/Set the Account Name for this service.
+      attr_accessor :storage_account_name
+
+      # Public: Get/Set the Service Bus Access Key (Issuer Secret) for this service.
+      attr_accessor :sb_access_key
+
+      # Public: Set the Service Bus Issuer for this service.
+      attr_writer :sb_issuer
+
+      # Public: Get/Set path of a CA certification directory containing certifications in
+      # PEM format.
+      #
+      # For example:
+      #   config.ca_file = 'ca_cert.pem'
+      attr_accessor :ca_file
+
+      # Public: Get the issuer for the service bus. If you set something using #sb_issuer=,
+      # then we use that. Otherwise, we default to the default issuer: "owner"
+      def sb_issuer
+        @sb_issuer || "owner"
+      end
+
+      # Public: Get/Set the Service Bus Namespace for this service.
+      attr_accessor :sb_namespace
+
+      # Public: Set the host for the Table service. Only set this if you want
+      # something custom (like, for example, to point this to a LocalStorage
+      # emulator). This should be the complete host, including http:// at the
+      # start. When using the emulator, make sure to include your account name at
+      # the end.
+      #
+      # Example:
+      #
+      #   config.storage_table_host = "http://127.0.0.1:10002/devstoreaccount1"
+      attr_writer :storage_table_host
+
+      # Public: Get the host for this service. If you set something using #storage_table_host=,
+      # then we use that. Else we default to Azure's default hosts, based
+      # on your account name.
+      def storage_table_host
+        @storage_table_host || default_host(:table)
+      end
+
+      # Public: Set the host for the Blob service. Only set this if you want
+      # something custom (like, for example, to point this to a LocalStorage
+      # emulator). This should be the complete host, including http:// at the
+      # start. When using the emulator, make sure to include your account name at
+      # the end.
+      #
+      # Example:
+      #
+      #   config.storage_blob_host = "http://127.0.0.1:10000/devstoreaccount1"
+      attr_writer :storage_blob_host
+
+      # Public: Get the host for this service. If you set something using #storage_blob_host=,
+      # then we use that. Else we default to Azure's default hosts, based
+      # on your account name.
+      def storage_blob_host
+        @storage_blob_host || default_host(:blob)
+      end
+
+      # Public: Set the host for the Queue service. Only set this if you want
+      # something custom (like, for example, to point this to a LocalStorage
+      # emulator). This should be the complete host, including http:// at the
+      # start. When using the emulator, make sure to include your account name at
+      # the end.
+      #
+      # Example:
+      #
+      #   config.storage_queue_host = "http://127.0.0.1:10001/devstoreaccount1"
+      attr_writer :storage_queue_host
+
+      # Public: Get the host for this service. If you set something using #storage_queue_host=,
+      # then we use that. Else we default to Azure's default hosts, based
+      # on your account name.
+      def storage_queue_host
+        @storage_queue_host || default_host(:queue)
+      end
+
+      # Public: Get the host for the ACS service.
+      def acs_host
+        "https://#{sb_namespace}-sb.accesscontrol.windows.net"
+      end
+
+      # Public: Get the host for the Service Bus service.
+      def service_bus_host
+        "https://#{sb_namespace}.servicebus.windows.net"
+      end
+
+      # Calculate the default host for a given service in the cloud.
+      #
+      # service - One of :table, :blob, :queue, etc.
+      #
+      # Returns a String with the hostname, including your account name.
+      def default_host(service)
+        "http://#{storage_account_name}.#{service}.core.windows.net"
+      end
+
+      #===================================================================
+      #*******************Management API configuration********************
+      #===================================================================
+
+      # Public: Get the Subscription Id and certificate key for the management API.
+      attr_accessor :management_certificate
+
+      # Public: Get/Set the Subscription Id  for the management API.
+      attr_accessor :subscription_id
+
+      # Public: Set the host  for the management API.
+      attr_writer :management_endpoint
+
+      #Public: Set the  private key for SSL/HTTPS request with PEM certificate
+      attr_accessor :http_private_key
+
+      #Public: Set the  certificate key for SSL/HTTPS request with PEM certificate
+      attr_accessor :http_certificate_key
+
+      # Public: Set the host for SQL Management API (SQL Server authentication Endpoint)
+      attr_accessor :sql_database_management_endpoint
+
+      def management_endpoint
+        if @management_endpoint.nil? or @management_endpoint.empty?
+          "https://management.core.windows.net/"
+        elsif !@management_endpoint.end_with?('/')
+          @management_endpoint += '/'
+        elsif URI(@management_endpoint).scheme.nil?
+          "https://#{@management_endpoint}"
+        else
+          @management_endpoint
+        end
+      end
+
+      def sql_database_management_endpoint
+        if @sql_database_management_endpoint.nil? or @sql_database_management_endpoint.empty?
+          "https://management.database.windows.net:8443/"
+        elsif !@sql_database_management_endpoint.end_with?('/')
+          @sql_database_management_endpoint += '/'
+        elsif URI(@sql_database_management_endpoint).scheme.nil?
+          "https://#{@sql_database_management_endpoint}"
+        else
+          @management_endpoint
+        end
+      end
+
+      # Public: Set this to enable Management certificate authentication or SQL Server authentication
+      attr_accessor :sql_database_authentication_mode
+
+      def sql_database_authentication_mode
+        sdam = @sql_database_authentication_mode || :sql_server
+        if [:sql_server, :management_certificate].include? sdam.to_sym
+          sdam.to_sym
+        else
+          :sql_server
+        end
+      end
+      
+    end
+  end
+end