From andy at arin.net  Thu Jun 10 09:03:35 2010
From: andy at arin.net (Andy Newton)
Date: Thu, 10 Jun 2010 09:03:35 -0400
Subject: [Arin-whoisrws] Updating Software and Data
Message-ID: <11E1FB2F-726B-46DF-B83C-38223E4A19A6@arin.net>

All,

As ARIN nears the finalization of the Whois-RWS development and deployment to production of these new services, we will be updating both the software and data on whoisrws-demo.arin.net.  It is our desire to upgrade the software to match as closely the software that will go to production, as well update the data with current production data and keep it up-to-date.

We will begin this upgrade at 10am EST today, at which time the services for whoisrws-demo.arin.net will not be available.  Once the software and data are refreshed, we will send an announcement to this list.

Andy Newton
Chief Engineer
ARIN

From andy at arin.net  Thu Jun 10 18:27:58 2010
From: andy at arin.net (Andy Newton)
Date: Thu, 10 Jun 2010 18:27:58 -0400
Subject: [Arin-whoisrws] Service restored
Message-ID: <6986846C-2143-4C33-81F8-77082774B3D7@arin.net>

The services at http://whoisrws-demo.arin.net have been restored, fresh data has been seeded, and data updates are flowing to the server.

If you see any issues or have any questions, please do not hesitate to send us a message.

Andy Newton
Chief Engineer
ARIN

From davism at ecr6.ohio-state.edu  Mon Jun 21 13:26:58 2010
From: davism at ecr6.ohio-state.edu (Michael T. Davis)
Date: Mon, 21 Jun 2010 13:26:58 -0400 (EDT)
Subject: [Arin-whoisrws] Formulating Web query for network name(s)
Message-ID: <01NOKYNL2MO295W2GF@ecr6.ohio-state.edu>

	I'm trying to figure out how to leverage the Web-based system to
make a query for a wildcarded network name.  Right now, I can query against
the ARIN Whois server with the string...

                            n . - <netname-prefix>*

For example...

                                 n . - APNIC-1*

,..which would list a summary of all networks with a name (i.e. "NetName")
that started with "APNIC-1."  If I visit...

                 http://whoisrws-demo.arin.net/ui/advanced.jsp

...I can specify the query as "APNIC-1*", and request a "Network" query for
the "Name," and get the same results.  How do I duplicate this by using a
Web query against http://whoisrws-demo.arin.net/rest/...?  Reading through
the API documentation, I thought it might be...

              http://whoisrws-demo.arin.net/rest/net;name=APNIC-1*

...but /net apparently doesn't support any "matrix parameters."

	In general, I need to know how to make a Web query for the Whois
equivalents of "n . - <netname-prefix>*" (which would list a summary of any
matches), and "n . + <netname-prefix>*" (which would provide the details for
each matching network).  Please advise.

Thanks,
Mike


From gdubin at arin.net  Mon Jun 21 13:49:15 2010
From: gdubin at arin.net (Garth Dubin)
Date: Mon, 21 Jun 2010 13:49:15 -0400
Subject: [Arin-whoisrws] Formulating Web query for network name(s)
In-Reply-To: <01NOKYNL2MO295W2GF@ecr6.ohio-state.edu>
Message-ID: <C8451E5B.5ABB%gdubin@arin.net>

Mike,

The URLs for searches will always be plural.  Using the example you provided, the proper URL would be:

http://whoisrws-demo.arin.net/rest/nets;name=APNIC-1*

Only the direct, linkable resources (i.e. a single network) are accessible via the singular "net" URI.

As another example, the organization FOOBAR can be linked to via:

http://whoisrws-demo.arin.net/rest/org/FOOBAR

But searching for all organizations with a handle starting with "FOO" would be:

http://whoisrws-demo.arin.net/rest/orgs;handle=FOO*

Also, the "+" to show a detailed record via the port 43 service can be accomplished using the "showDetails" query parameter in REST.  If you want to show the details of your APNIC-1* query, you would use:

http://whoisrws-demo.arin.net/rest/nets;name=APNIC-1*?showDetails=true

Hope this helps!

Regards,

Garth Dubin
ARIN Software Engineer


On 6/21/10 1:26 PM, "Michael T. Davis" <davism at ecr6.ohio-state.edu> wrote:

       I'm trying to figure out how to leverage the Web-based system to
make a query for a wildcarded network name.  Right now, I can query against
the ARIN Whois server with the string...

                            n . - <netname-prefix>*

For example...

                                 n . - APNIC-1*

,..which would list a summary of all networks with a name (i.e. "NetName")
that started with "APNIC-1."  If I visit...

                 http://whoisrws-demo.arin.net/ui/advanced.jsp

...I can specify the query as "APNIC-1*", and request a "Network" query for
the "Name," and get the same results.  How do I duplicate this by using a
Web query against http://whoisrws-demo.arin.net/rest/...?  Reading through
the API documentation, I thought it might be...

              http://whoisrws-demo.arin.net/rest/net;name=APNIC-1*

...but /net apparently doesn't support any "matrix parameters."

        In general, I need to know how to make a Web query for the Whois
equivalents of "n . - <netname-prefix>*" (which would list a summary of any
matches), and "n . + <netname-prefix>*" (which would provide the details for
each matching network).  Please advise.

Thanks,
Mike
_______________________________________________
Arin-whoisrws mailing list
Arin-whoisrws at lists.arin.net
http://lists.arin.net/mailman/listinfo/arin-whoisrws

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.arin.net/pipermail/arin-whoisrws/attachments/20100621/419b4824/attachment.html>

From davism at ecr6.ohio-state.edu  Mon Jun 21 16:41:54 2010
From: davism at ecr6.ohio-state.edu (Michael T. Davis)
Date: Mon, 21 Jun 2010 16:41:54 -0400
Subject: [Arin-whoisrws] Formulating Web query for network name(s)
Message-ID: <01NOL6A7YVYS96P61T@ecr6.ohio-state.edu>


>Date: Mon, 21 Jun 2010 13:49:15 -0400
>From: Garth Dubin <gdubin at arin.net>
>Subject: Re: [Arin-whoisrws] Formulating Web query for network name(s)
>[...]
>
>Mike,
>
>The URLs for searches will always be plural.  Using the example you provided, the proper URL would be:
>
>http://whoisrws-demo.arin.net/rest/nets;name=APNIC-1*
>
>Only the direct, linkable resources (i.e. a single network) are accessible via the singular ?net? URI.
>
>As another example, the organization FOOBAR can be linked to via:
>
>http://whoisrws-demo.arin.net/rest/org/FOOBAR
>
>But searching for all organizations with a handle starting with ?FOO? would be:
>
>http://whoisrws-demo.arin.net/rest/orgs;handle=FOO*

        I would strongly recommend documenting the difference between the
singular and plural objects.  This isn't even hinted in the API documentation.
It would also be useful to know what "matrix parameters" are available with the
nets object, as you've documented in section 4.4.2 for all the other objects.


>Also, the ?+? to show a detailed record via the port 43 service can be accomplished using the ?showDetails? query parameter in REST.  If you want to show the details of your APNIC-1* query, you would use:
>
>http://whoisrws-demo.arin.net/rest/nets;name=APNIC-1*?showDetails=true

        OK, this is all quite useful.  Is there a way to initiate a search
query and obtain the results in plain text using the "file extension" (i.e.
".txt") mechanism.  For example, where does ".txt" get included in...

http://whoisrws-demo.arin.net/rest/nets;name=APNIC-1*

...or are searches limited to using the Accept header mechanism?  I tried...

http://whoisrws-demo.arin.net/rest/nets;name=APNIC-1*/.txt

...which almost gets me what I need.  (Omitting the "/" before ".txt" doesn't
provide any useful results.)

        I also have some questions regarding other aspects of this system:

 o In trying all this out, I keep encountering many security dialogs from my
   browser (IE7), indicating I'm attempting to access secure information.  I'm
   using http://... URLs, not https://... URLs, so what is the source of these
   confirmation dialogs, and is there any way to suppress them?  Normally, this
   is an indication that the Web site prefers to be accessed via https, but
   neither the demo site nor your mailing list system (where I also ran into
   this behavior) are configured to accept access via https.

 o It looks like you're no longer providing country information in the search
   results.  Will we eventually see the return of this information?

 o I note that the above search query against "APNIC-1*" tells me that there
   are more than 10 results, but only the first 10 have been returned (i.e. the
   typical truncation situation). Will the limit be bumped up to 256, as
   documented, by the time this system actually goes live?


>Hope this helps!
>
>Regards,
>
>Garth Dubin
>ARIN Software Engineer
>
>
>On 6/21/10 1:26 PM, "Michael T. Davis" <davism at ecr6.ohio-state.edu> wrote:
>
>       I'm trying to figure out how to leverage the Web-based system to
>make a query for a wildcarded network name.  Right now, I can query against
>the ARIN Whois server with the string...
>
>                            n . - <netname-prefix>*
>
>For example...
>
>                                 n . - APNIC-1*
>
>...which would list a summary of all networks with a name (i.e. "NetName")
>that started with "APNIC-1."  If I visit...
>
>                 http://whoisrws-demo.arin.net/ui/advanced.jsp
>
>...I can specify the query as "APNIC-1*", and request a "Network" query for
>the "Name," and get the same results.  How do I duplicate this by using a
>Web query against http://whoisrws-demo.arin.net/rest/...?  Reading through
>the API documentation, I thought it might be...
>
>              http://whoisrws-demo.arin.net/rest/net;name=APNIC-1*
>
>...but /net apparently doesn't support any "matrix parameters."
>
>        In general, I need to know how to make a Web query for the Whois
>equivalents of "n . - <netname-prefix>*" (which would list a summary of any
>matches), and "n . + <netname-prefix>*" (which would provide the details for
>each matching network).  Please advise.
>[...]

Thanks,
Mike 



From gdubin at arin.net  Tue Jun 22 14:09:30 2010
From: gdubin at arin.net (Garth Dubin)
Date: Tue, 22 Jun 2010 14:09:30 -0400
Subject: [Arin-whoisrws] Formulating Web query for network name(s)
In-Reply-To: <C846471C.5AD2%gdubin@arin.net>
Message-ID: <C846749A.5AFB%gdubin@arin.net>

Mike,

>        I would strongly recommend documenting the difference between the
> singular and plural objects.  This isn't even hinted in the API documentation.
> It would also be useful to know what "matrix parameters" are available with the
> nets object, as you've documented in section 4.4.2 for all the other objects.

I will be updating the document to include the network matrix parameters and clarify the differences between the singular/plural.  These updates should be visible shortly.

>        OK, this is all quite useful.  Is there a way to initiate a search
> query and obtain the results in plain text using the "file extension" (i.e.
> ".txt") mechanism.  For example, where does ".txt" get included in...

The file extensions are only documented and supported for the single resources at this time.  Currently, searching is only supported in XML.  Your browser will automatically render it using the XSLT into HTML.  While this may change in the future, the current intent is to provide a way to search for content and then send direct resource links in a variety of formats.

 > In trying all this out, I keep encountering many security dialogs from my
 > browser (IE7), indicating I'm attempting to access secure information.  I'm
 > using http://... URLs, not https://... URLs, so what is the source of these
 > confirmation dialogs, and is there any way to suppress them?  Normally, this
 > is an indication that the Web site prefers to be accessed via https, but
 > neither the demo site nor your mailing list system (where I also ran into
 > this behavior) are configured to accept access via https.

This is probably caused by the header and footer images being pulled from the main (www.arin.net) site.  We're discussing some alternatives to help prevent this from being an issue in production.

 > It looks like you're no longer providing country information in the search
 > results.  Will we eventually see the return of this information?

The country information is available for POCs and organizations if you add the showDetails=true flag to the search output.  As an example:

http://whoisrws-demo.arin.net/rest/orgs;handle=FOO*?showDetails=true
http://whoisrws-demo.arin.net/rest/pocs;handle=ARIN-HOST*?showDetails=true

The network and AS searches will provide references to their corresponding organizations and POCs if you use the showDetails flag but these resources themselves do not have contact information.

> typical truncation situation). Will the limit be bumped up to 256, as
> documented, by the time this system actually goes live?

Absolutely!  I've just verified with our operations department and we are planning on rolling out with a limit of 256 in the production system.

Thank you for providing this feedback.

Regards,

Garth Dubin
ARIN Software Engineer
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.arin.net/pipermail/arin-whoisrws/attachments/20100622/afe79837/attachment.html>

From tedm at ipinc.net  Thu Jun 24 15:23:57 2010
From: tedm at ipinc.net (Ted Mittelstaedt)
Date: Thu, 24 Jun 2010 12:23:57 -0700
Subject: [Arin-whoisrws] [arin-announce] ARIN's RESTful Whois Directory
 Service Available 26	June
In-Reply-To: <4C238F3A.1030200@arin.net>
References: <4C238F3A.1030200@arin.net>
Message-ID: <4C23B0CD.4020408@ipinc.net>

"...ARIN will continue to
maintain services for the NICNAME/WHOIS protocol on TCP/43. This is
achieved by using a proxy service to translate traditional ARIN Whois
queries into Whois-RWS queries. However,..."

Can we get the source for this proxy code, please?

Thanks,
Ted

On 6/24/2010 10:00 AM, Member Services wrote:
> ARIN is deploying an improved Whois service called Whois-RWS on 26 June
> 2010. Included in the deployment are the following services that provide
> the general public with access to ARIN's registration data.
>
> * a RESTful Web Service (RWS)
> * a NICNAME/WHOIS port 43 service
> * a user-friendly web site (http://whois.arin.net)
>
> When using Whois-RWS you will notice some differences in behavior for
> certain queries and corresponding result sets on the NICNAME/WHOIS TCP
> port 43 service. These minor differences are documented at:
>
> https://www.arin.net/resources/whoisrws/whois_diff.html
>
> ARIN?s Directory Service for registration data has used the
> NICNAME/WHOIS protocol since its inception. The limitations of the
> NICNAME/WHOIS protocol are well known and documented in RFC3912.
> Whois-RWS was created as an alternative to the ARIN Whois and will
> provide much richer functionality and capability to the community.
>
> Whois-RWS can easily be integrated into command line scripts, or it can
> be used with a web browser, which makes it applicable for programmatic
> consumption and accessible for interactive use. ARIN will continue to
> maintain services for the NICNAME/WHOIS protocol on TCP/43. This is
> achieved by using a proxy service to translate traditional ARIN Whois
> queries into Whois-RWS queries. However, ARIN recommends use of the
> RESTful Web Service.
>
> Those who choose to use the Whois-RWS Proxy will find it has many
> features unavailable over the existing Whois service, including:
>
> * Support for new query types such as CIDR queries
> * Better feedback for ambiguous queries
> * More finely scoped record type queries
> * Options for NICNAME/WHOIS clients that re-interpret traditional
> parameters used by ARIN's service.
> * RESTful URL references, useful for embedding into documents and e-mail
> * Better grouping of record types and delineation of results
>
> Another major benefit is that data from ARIN?s registration database is
> distributed to the Whois-RWS servers many times throughout the day,
> versus the once-a-day update of ARIN?s previous Whois service. Changes
> will be reflected more quickly through Whois-RWS, so query results will
> be more current than the previous Whois service.
>
> ARIN continues to welcome community participation on the Whois-RWS
> mailing list, and we invite you to subscribe and provide feedback to:
>
> http://lists.arin.net/mailman/listinfo/arin-whoisrws
>
> Regards,
>
>
> Mark Kosters
> Chief Technical Officer
> American Registry for Internet Numbers (ARIN)
>
>
>
> _______________________________________________
> ARIN-Announce
> You are receiving this message because you are subscribed to
> the ARIN Announce Mailing List (ARIN-announce at arin.net).
> Unsubscribe or manage your mailing list subscription at:
> http://lists.arin.net/mailman/listinfo/arin-announce
> Please contact info at arin.net if you experience any issues.
>


From markk at arin.net  Sat Jun 26 11:05:04 2010
From: markk at arin.net (Mark Kosters)
Date: Sat, 26 Jun 2010 11:05:04 -0400
Subject: [Arin-whoisrws] ARIN's RESTful Whois Directory Service
 Available 26 June
In-Reply-To: <4C23B0CD.4020408@ipinc.net>
References: <4C238F3A.1030200@arin.net>
 <4C23B0CD.4020408@ipinc.net>
Message-ID: <20100626150503.GA1565@arin.net>

On Thu, Jun 24, 2010 at 03:23:57PM -0400, Ted Mittelstaedt wrote:
> "...ARIN will continue to
> maintain services for the NICNAME/WHOIS protocol on TCP/43. This is
> achieved by using a proxy service to translate traditional ARIN Whois
> queries into Whois-RWS queries. However,..."
> 
> Can we get the source for this proxy code, please?

Ted,

The code used for this particular application is closely tied to the 
internal workings of ARIN and would not be of much use externally to
someone who wants to set up a proxy service themselves.

However..

One of the main components that is required in building a service
is the XSLT which performs the transform between the raw XML provided
by Whois-RWS to the legacy format served up in port 43.  The XSLT can be 
used to understand the mapping between the new and old formats. We plan on 
adding more XSLT examples to the Whois-RWS API documentation beyond the 
POC example that exists today.

If this does not address your issue and you believe that ARIN should consider 
building a public domain software package for this type of thing, your 
suggestion is welcome via the ARIN Consultation and Suggestion Process 
(ACSP) located at https://www.arin.net/app/suggestion/ .

Regards,
Mark Kosters
ARIN CTO