fripa 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c4b9a552724de9440ae408046a6e38c16f8d384726525ad589ba864dce04ae14
-  data.tar.gz: 4330ef7308fd8302b2c513b6f899ebdde194baea527b6d9c93eb633e1bf9e12b
+  metadata.gz: d50f7498dd0bbd51cdedde2bdd30db19e23d50062bcc013bc4ff560888f8a830
+  data.tar.gz: b677039839af7e04549d7277976798953f48c551df25c7c3f97fb432cf176c71
 SHA512:
-  metadata.gz: 27f407fe7b2e73c25c3800b2caddfe6e2c249895aeaec1a1a2fb7bf8435207d5084b051b024bff153addc0908391b3971e49a233398e9ca253ac4159e9497c1a
-  data.tar.gz: e45bda9e4d673f372421f8ed90173d83f153ae7d7a074d741750f3dd00b6057b09079e82d314f5987695331b983d80456625ff04fe7b00fb7f535b31a8bf60b3
+  metadata.gz: c491390606580cfecdf5a77551a00d42e661249f2cc2975a28de5bbe3ad5963a116c069d282effddd59ef6dba975f6b0185b872fd5af5b7c01058cc0e5567f83
+  data.tar.gz: 4fc759c7aa47dae2ede657e79873fc721a1fcb41480240ca695a352a9ea64cb306247623b32340047709fbb951bb848dcb4840db8990b661fed14aa18020799d

data/README.md

@@ -4,6 +4,9 @@ A Ruby client for the FreeIPA JSON-RPC API.
 
 Docs: [FreeIPA JSON-RPC API](https://freeipa.readthedocs.io/en/latest/api/json-rpc.html)
 
+## What is FreeIPA
+FreeIPA (Free Identity, Policy, Audit) is an open-source identity management system for Linux/Unix environments. It provides centralized authentication, authorization, and account information by integrating LDAP, Kerberos, DNS, and certificate management. Essentially, it helps organizations manage users, groups, and access policies in a secure and unified way.
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -33,7 +36,9 @@ Configure your FreeIPA server settings globally. These settings are shared acros
 ```ruby
 Fripa.configure do |config|
   config.host = 'ipa.example.com'
-  config.verify_ssl = true  # default: true
+  config.port = 8443         # optional, default: 443 (standard HTTPS port)
+  config.scheme = 'https'    # optional, default: 'https' (use 'http' for local development)
+  config.verify_ssl = true   # default: true
 end
 ```
 
@@ -42,6 +47,8 @@ end
 ```ruby
 Fripa.config = {
   host: 'ipa.example.com',
+  port: 8443,        # optional
+  scheme: 'https',   # optional
   verify_ssl: true
 }
 ```
@@ -51,6 +58,8 @@ Fripa.config = {
 ```ruby
 config = Fripa::Configuration.new(
   host: 'ipa.example.com',
+  port: 8443,        # optional
+  scheme: 'https',   # optional
   verify_ssl: true
 )
 Fripa.config = config
@@ -60,9 +69,24 @@ Fripa.config = config
 
 ```ruby
 Fripa.config.host = 'ipa.example.com'
+Fripa.config.port = 8443      # optional
+Fripa.config.scheme = 'https' # optional
 Fripa.config.verify_ssl = false
 ```
 
+### Local development example
+
+For local FreeIPA instances running on HTTP:
+
+```ruby
+Fripa.configure do |config|
+  config.host = 'localhost'
+  config.port = 8080
+  config.scheme = 'http'
+  config.verify_ssl = false
+end
+```
+
 ## Usage
 
 ### Creating a Client

data/lib/fripa/configuration.rb

@@ -6,23 +6,32 @@ require "uri"
 module Fripa
   # Configuration for Fripa
   class Configuration
-    attr_accessor :host, :verify_ssl
+    attr_accessor :host, :port, :scheme, :verify_ssl
 
-    def initialize(host: nil, verify_ssl: true)
+    def initialize(host:, port: nil, scheme: "https", verify_ssl: true)
       @host = host
+      @port = port
+      @scheme = scheme
       @verify_ssl = verify_ssl
     end
 
     def base_url
-      URI::HTTPS.build(host: host)
+      build_uri
     end
 
     def login_url
-      URI::HTTPS.build(host: host, path: "/ipa/session/login_password")
+      build_uri(path: "/ipa/session/login_password")
     end
 
     def api_url
-      URI::HTTPS.build(host: host, path: "/ipa/session/json")
+      build_uri(path: "/ipa/session/json")
+    end
+
+    private
+
+    def build_uri(path: nil)
+      uri_class = scheme == "https" ? URI::HTTPS : URI::HTTP
+      uri_class.build(host: host, port: port, path: path)
     end
   end
 

data/lib/fripa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fripa
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fripa
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Bruno Costanzo